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SmalltalkAgents v2.0 


SmalltalkAgents** (S'lA) is a sophisticated, dynamic application 
development and delivery environment based a modem 
version of Smalltalk, Productivity is no longer measured in 
lines of code, but in prefect completion time. 


The Agents Object System™ (AO/S) is an underlying task 
framework, housing components and services that save you 
years of work, it is the foundation of the QKS Product 
Family, and includes significant features that exist now in 
SmalltalkAgents, and others that will be released in 
commercial form over die next 12 months. 


A New Generation of the Wl 

Smalltalk Language jr* 

QKS Smalltalk ™ revolutionized the existing Smalltalk lan¬ 
guage by adding Pascal and C/C 11 -like data structures, fast 
and efficient data structure operators, and the richness of 
LISP-like dynamic list processing, QKS Smalltalk rules and 
syntax fir on one page, greatly reducing your learning curve. 
In addition, automatic garbage collection and object-based 
typing will free you from tedious memory management and 
bookkeeping chores. 


Task Frameworks and Services 

Tiie AO/S is a value-added collection of “components” and 
“services" embedded in SmalltalkAgents and Visual Agents, 
and optionally available for distribution with your 
applications. AO/S Services include 

* Client/server Cyberspace engine (TCP/IP, WWW, Email) 

• DTP/word processing engine (>32K styled text, full 

pagination and report layout) . 

• Database collaboration engine 

* Distributed objects (like DSOM) 

* Full-featured Smalltalk compiler * 

• Cross-platform frameworks and components 


S Source Code Information 
Management System 

STA increases your productivity through a sophisticated 
database for source code management. It provides an 
almost infinite variety of ways to cross-reference, access, 
view, and manipulate your code and objects. 


OpenDoc Integration for Free 

Any component built in AO/S will function as an 
OpenDoc component or container, and components 
from different (non-AG/S) sources can be leveraged by seam¬ 
lessly integrating diem into Lhe AO/S system, regardless 
of origin. 


Includes International Wi 
Character Support 

Because STA is architected to transparently support 
WorldScript™ and UNICODE international character sets 
(up m 3-byre characters), your application is ready for the 
international market from day one. 


Quasar Knowledge Systems, Inc, 

9818 Park wood Drive 

Bethesda, MD 20814 USA 

Tek (301} 530-4853 Fax: (301} 530-5712 


Contact us to get the latest edition of your 

FREE QKS “Hot” CD-ROM* 

showcasing the QKS Product Family. You can reach ns by calling 1-800-296-1339 or through 
the Internet at <infb(o : qks.com> or visit our home page at http: www.qks.com. 

*Includes working imion of STA that you can test chive! 























Eddy Award Winner for Bent New Developer Tool 

- MacUser Editors Choice Awards, 1993 



'A distinct improvement over ResEdiL ” 

- MacTech / MacTulor 

“Resorcerer’s data template system is amazing!” 

-Bill Goodman , author of Compact Pro 

”Nuke ResEdit! Resorcerer is mission-critical for us 

- Dave Winer , Userland Frontier 

"The color pixel editors are wonderful! A work of artF 

- Dave Winzler, author of Microseeds Rcdu.x 

“Every Macintosh developer sho uld own a copy of Resorcerer. ” 

- Leonard Rosenthal, Aladdin Systems 

“Resorcerer will pay for itself many times over in saved time and effort 

- MacUser review 

“The template that disassembles TICTs is awesome1* 

- Bill Steinberg, author ofPyro! and PBTools 

*Resorcerer proved indispensible in its own creationF 

- Doug McKenna, author of Resorcerer 

*.. a wealth of time-saving tools, ” 

MacUser Review, Dec . 1992 



Version 1.2.4 


The Resource Editor for the Macintosh Wizard 


ORDERING INFO 


Needs: £Mac Plus, > Sys 4.2, I MB 
Likes: >Mac Plus, > Sys 7.0, 2MB 
32-bit dean, AU/X compatible 

Price: $256 {decimal) 
(Educational, quantity, or 
other discounts available) 

Includes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 

Payment: Check, PO s, or Visa/MC 

Extras (call us): 

COD, FedEx, UPS Blue/Red, 
International Shipping 


Downloadable Demos/Updaters: 

AppleLink: Software Sampler 
AOL: Software Libs/Development 
CompuServe: MACDEV/Tbols 
or call us. 


* New ‘cicn\ 4 j>pat\ ‘crsr\ 'acur', *pltt\ 4 clut’ editors 

* Powerful icon family editing (all 9 icon types) 

* Color pixel anti-aliasing, dithering, and lots more 

* Complete ‘PICT* disassembly and reassembly 
New 1-2 Features: * Resource sorting; ROM resource browning 

* 120 template field parsing types now supported 

* New insertion & deletion template field types 
■ Text-only ‘PICT* resources 

* Lots of improvements throughout 

■ Easier, faster, more Mac-like, and more productive than ResEdit 

• Safer memory-based, not disk-file-based, design and operation 

» Ail file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and open s/m arks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rcz-Like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 
•Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, ictb’s, lists and popups, even create C source code 

• Integrated single-window Hex/Gode Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Well-designed, helpful developer tools being added all the time 

• Relied on by thousands of Macintosh developers around the world 


MATHEM^STHETICS, INC. 

P.O. Box 298 * Boulder • CO • 80306-0298 • USA 
Phone:(303)440-0707 * Fax:(303)440-0504 
AppleLink/AmericaOnline: RESORCERER ■ Internet: resorcerer@aol.com 
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Wh^ ? You missed MacHack again? What arc wc going to do 
with you? Oh, well, this tenth anniversary of Mac Hack had much 
to offer for about 300 Macintosh hackers from all over the map. 

Some people go for the sessions. Some people go for the 
caffeine. Some people go for the amazing things that happen 
when they deprive their body of sleep for 72 hours. Nolxxly goes 
for the food! And this year nobody went for the luxurious 
accommodations of the Southfield, Michigan. Ramada (who needs 
air conditioning, anyway?). 

Nevertheless, this event ranks among the few unmissable events 
of the year lor those who just can't get enough of Mac programming. 
Why? The people, of course. Nowhere else can you find such a 
favorable ratio of hackers to marketeers. It's one of the few places 
where marketing, Windows, and other holy cows come under 
constant and brutal attack, much to the delight of the crowd. 

The Ninth Annual Mac Max rM Mad lack Best Hack Contest 
(hosted each year by Greg Marriott and yours truly) attracts a 
wildly-di verse set of entries, and accounts for the bleary-eyed, 
caffeine-pumped, sleep-deprived crew of entrants who show their 
wares to a rabid, merciless crowd of their peers. The show starts at 
midnight, and Follows two days of crazed hacking. 

fin often asked how one goes about winning. Strangely, I gcL 
a disapproving look (or small amounts of cash) when I suggest 
bribing the judges. I've never won (I’d just ger accused of 
cheating, anyway), so instead 111 offer a few tips on how to have a 
great lime at MacHack. 

I wandered around the machine room at 2AM, seeing if I 
couIt! interest anyone in a Web-hack idea I'd been mulling over I 
didn’t know whether I d find someone to work with on this hack, 
or on another hack, but 2AM is a good time to find the right kind 
of person. Many people were already working on their hacks, but 
I met a guy Td never met before, Grant Neufeld. Strangely, 
though, I'd lx:en to his web site <http;//arpp1.carietortca/grant/>, He 
was working on a CGI shell - it was perfect for hosting my portion 
of the hack, and fie liked my idea. 

We started working right away. 1 le prepared the CGI shell, and 
I hacked out some code to play with QuickTime’s compression 
manager and the (unpublished) Layer Manager. We changed designs 
about a thousand times, and finally got something mostly working, 
Al that [Tome we decided that public relations was the next most 
important thing to address, so we put together a killer Alx>ut.,, box, 
picked a cool name ( Wbatson?), and Grant made the icon. 

Instead of getting our demo rehearsed, wc decided to add 
another feature (the real killer feature), and found ourselves up 
against the deadline that 1 myself had imposed What Lo do? Ha! I 
changed the rules, and moved the start of the Hack Show ro 12:30! 
(Everyone accused me of it anyway, and it makes a better story' if l 
just give in and say so, in spite of the fact that the Hack Show 
equipment really wasn't ready, honest!) 

1 low did it tum out? Wc didn't win (something about running 
out of the rcx>m in the middle of demonstrating the hack at the 


Hack Show, but that's a whole 'nuther story). In retrospect, if we’d 
really wanted to win, we probably should have gone ahead and 
made t-shirts. That would have made all the difference, no doubt, 
Nevertheless, we had a blast. In the process of madly throwing 
together the hits and pieces of this hack, we met and got help from 
roughly a dozen people, we faked up a fun photo with Photoshop, 
and we dabbled in several areas of the Macintosh toolbox we 
hadn't played with before, all the while relishing the camaraderie, 
chaos, and caffeine. 

Convinced? Want to enjoy the conference, at least vicariously? 
The list of winners and some of the hacks are at 
<http://www.machack.com/>. Want to iry out Whatson? 
< h ttp7/www . ha x .co m/wh atson . atg i >. 

From the "Where’s the Beef?” Department 

Microsoft’s reputation for out-marketing Macintosh prevails in the 
coasumer arena. Microsoft holds die tide in the developer arenaas 
well. For example, Microsoft continued their full frontal assault at 
MacHack, both with their Windows?!) pro conference, and with 
ample support and cosponsoring of the machine room and Internet 
connection. On the other hand, Apple, once famous for insanely- 
great developer relations, has recently fared poorly in Macintosh 
developers' hearts and minds, losing ground as Microsoft presses 
on with aggressive developer relations efforts. This year's strong 
sponsorship of MacHack stands as a clear and welcome exception. 

What's a Macintosh zealot to do? Well, never fear. Hope 
springs eternal. In what might be Apple's answer to Microsoft's 
challenge, Apple recently brought Guy Kawasaki back on hoard as 
an Apple Fellow. I lis mission? To "represent developer issues and 
perspectives to Apple ", among other things. 

In that vein, he has started up a mailing list designed for the 
Macintosh faithful He wants list participants to help him 
understand what developers need and want. 

If you can handle a healthy dose of e-mail, join the list by 
sending a message to < mail to: semper.fi@thingl.info.apple.com> with 
the body of the message (not the subject line) containing 
subscribe YourRealNama. Once you're on the list, you can send 
mail to the .same address. You can also send mail directly to Guy 
at <mailto: MacWay@aul.com> 

Food For Thought 

"Can one Guy get ahead of (Microsoft's] James Flamondon? He’s 
pretty far out there!" - Name unthbetd 

"You know you're really having fun when you rind yourself falling 
asleep at breakfast"* - Brad Kollmyer, bradk@vitalso/t,com 

It wasn't broken air conditioning at the MacHack Windows 
preconference - it was the Mac programmers burning in 
HdL." gt 

- Anonymous 
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Hach year, the illegal use of software 
consumes nearly 50% of your potential 
revenues. With the flames of piracy eating 
away at your profits, can you afford not to 
protect your software? 


Software Obtained Illegally, toy region. 1993 vs. 1994 


AfritAi'Midcfle East 

5666,440,106 

392,607,056 

$3,963,527,364 

Asia 

4.350,981,640 

$4,900,062,960 

Europe 



$821 992,751 

Latin America 

1,334,894.665 

U.SJCartada 

$2,487,360,944 

3,131.456.600 

Total lot t993: $12,640,204,124 

Total lor 1994: $15,212,700,215 

Source BSA 


MacHASP® is widely acclaimed as the world’s 
most advanced software protection solution 
for Macintosh computers. Since l l )84, 
thousands of leading Mac and PC developers 
have used over one million Macl IASP and 
HASP keys to protect billions of dollars worth 
of software. Why? Because MacHASP’s 
security, reliability, and ease-of-use led them 
to a simple conclusion: MacHASP is the most 
effective software protection system available. 



Today, more developers are choosing 
MacHASP than any other software protection 
method. To leam why, and to see how easily 
you can increase your revenues, call now to 
order your MacHASP Developer’s Kit 


1 - 800 - 223-4277 


ALADDIN 


The Professional's Choice 

North Aladdin Software Security Inc. 

America Tut. (800) W 4277,212-5^ 5678 

Fax: 212-564 3377 
E-mail: saks#Uasj).oom 
WWW. hupJ/www Imsp.cont/ 

Inti Office Aladdin Knowledge Systems Ltd- 

Td 972-3-537 5795. Fa* 972-3-537 5796 
E-mail aliitldln^alatklin mil 

United Aladdin Knowledge 

Kingdom Systems UK Ltd. 

Tel: G1753-622266, Fat 01753-622262 

France Aladdin France SA 

Tel: MOSS9885 t Fax: l 41 21 90 56 






MICROSOFT, 


WlMXWS 


COMSTIBIF 


Mac'OS 


.Aladdin Beneiui ffltfli 19777 ■ Matldki Japan 0426 BO 71 91 ■ Aladdin Russia. 096 9030588 m Austrafe fttitab 3 0585685 • Czech Auk. 2 WOtt 
. Chile 2 m 1380 . Denmark fercfldOT 39 577300 ■ Egy* Tarttou 2 3604632 ■ Finland ftl-Spiiifi & m 3S?C - Germany CSS 201 27981)4 

e Greece Lftfrair* I ■ India StWia* II 2218254 p Italy Parlno Onto ? 26147300 a Korea OflM 2 m ■Mfli ■ fttetico SSSofl 5 M39770 

a Hew Zealand 1mm * 5068014 ■ Poland Swtterm 61 4802/3 ■ Portugal Riiurmaiica I 4116060 a Romania liilmato 64 133112 

■ Simlh Africa D Le Hflut 11 aai 4fD4 » Spain PT.ILiithwne 3 4493193 n Switzerland GpOQ Si 7100722 ■Taiwan T«fl 2 556 9876 iTurkc^ Mtooheta 312 467 7504 

















I t’s the highly-regarded industry 
standard, used by more developers 
than any other Macintosh develop¬ 
ment system. And now it’s been 
totally re-engineered for Power Mac. 

Introducing Symantec C++™ 8,0 
for name Power Mac, 

Not since the original THINK 
C™ has anything so dramatically 
boos Led your productivity. There's a 
Visual Architect™ to generate GUI 
code instantly. An advanced Project 
Manager to handle tire largest and 
most complex jobs. Plus native 
Power Mac cools for radically 




typUfjOUm- -frnrtO, 





Roost your productivity with our Visual Architect, Advanced Editor, 
Debugger and Project Manager. 


File EiNE mgi» rom D»I*W totfE* llftodam g 


•s n 


JfcEtalH -eQSUb&h* 

^include ^ToolUlils h> 
f include <SegLMdh> 

// r 11 t-a urea will) Heel angles 
vo ul miV^ttA^K«ci -arsaj 


7ms bitt ton ip fids a comma/td to 
matte a now tiurMnur 


Cmmm mw Window 


The Industry Standard Just Moved To A Higher Power. 
Symantec C++ 8.0 for Power Mac. 


improved performance. 

Draw on the 
Industry Standard. 

With Symantec C++ 8.0, you sim¬ 
ply draw die user interface including 
windows, dialogs, controls, icons and 
menus. Then the built-in Visual 
Architect generates the code with the 
click of a mouse. Now you can spend 
more rime on what really sets your 
application apart its functionality. 

A Higher Standard 
For Speed. 

The new high-performance com¬ 
piler is dramatically faster than rhe 
previous version, so you can become 
more productive chan ever. 

And for even more power, we’ve 
added an Advanced Project Manager. It 


gives you drag and drop so you can eas¬ 
ily add files. Named Option Sets for 
changing complex sets of options fast, plus 
support for even the largest applications. 

Theres also a new editor and a 
browser for modifying and navigating 
source Hies, a new debugger, an 

New; FastC 

And C++Compilers 

for both Mac and Power Mac 

Nhwi Visual Architect 

for the Power Mac 

News Think Ci ass Library 

2.0 for Power Mac 

Nhwi Popup Menus 

take you right to declarations & headers 

New! Debugger 

for nested projects and shared libraries 

New! Project Manager 

for multiple targets and 

hierarchical support 

Newi Spl it Pane Editor 

for syntax highlighting and 
auto forma tting. 




SYMANTEC. 


incremental linker, THINK Class 
library™ 2,0 and much mote. 


A Double Standard For 
68k And Power Mac. 


Symantec C++ 8.0 is the first 
native Mac/Power Mac development 
system to support C++ templates, 
nested classes and multiple inheri* 
tance, as well as ANSI G, Plus 8.0 
includes version 7.0 for 68K support. 

This double standard gives you 
everything you need for both 68K 
and Power Mac development. 


To order at a special upgrade price of $i49 95. 


call IAS00-62#d777 hxt 9H2L 
Re wrr to ask about the Sjmtmec 
Developers Advantage Program 
for premium tuppon and regu¬ 
lar update r. Or visit your local 
software store. 



Price £iiOii In U. S, only, For hmhl: informal ion in CanatU, call l-80£+6<t7*866l. firr. 5513, In Australia. call 2-879-G577. in Europe, call 31-71-353111. Symantec C++j Visual Architect, 
THINK Class Ubrary arc Trademark*ofSyirwnm Corporation. Ail other [r.idcm.nks arc die property oftheir respective holders.® 1W5 Symainec Corporation. All rights reserved. 


























































































GETTING 

STARTED 


By Dave Mark, MacTecb Magazine Regular Contributing Author 



PowerPlant 


This month, we're going to take a look 
at PowerPlant, the framework included 
on every Code Warrior CD. Jf you own 
Symantec C++, take heart: well get to 
the TCL in a future column. In the 
meantime, follow along anyway. Who 
knows, you might find yourself making 
the switch to PowerPlant someday. 

This Month's Program 

1 don't know about you but, after four 
month's sLraight of menus, I'm ready for 
something else. So instead of talking 
about PowerPlant and menu handling 
(we’ll do that in a future column), this 
month's program will introduce 
PowerPoint's messaging system. 

As you design your PowerPlant 
programs, you'll work with objects called 
broadcasters and listeners. A broadcaster 
sends a message and a listener receives 
that message. In this month's program, 
we'll create a window containing a 
button. Each time Lhe button is clicked, 
it will send a message to any objects 
registered as listeners to it. Basically, 
this means that the broadcasting objects' 
BroadoastMe ssaget) member 
function calls the listening object’s 
ListenToMessageO member 
function. 

This mechanism is simpler rhan tl 
sounds. As we build our project, just 
remember thal Lhe button is a 
broadcaster, and that the class 
CDashboardApp will be the listener. 

If you have the CW6 documentation, 
you might warn to read the section 
named Lliroadcaster Sl LLisrener in the 
PowerPlant manual (chapter jyage 93). 

As is usually the case when 


working with a framework, well take an existing PowerPlant 
example and modify it to suit our needs. 


■ Duplicate the folder *CodeWarrior6:Metrowerks 
PowerPlant :More PowerPlant Examples:Dashboard Starter*. 


If you run one of the projects in this folder (either 
Dashlx>ard68K,p or DashboardPFC.jj), you'll see the window 
shown in Figure 1. To quit the program, select Quit from the 
File menu. As you can see. Quit is the only item in the File 
menu. In a future column, well add some menus and items to 
a PowerPlant program. For now, let’s add a button to the 
Dashboard window. 



Figure 1, The Dashboard Starter window, 
before our modifications. 

Editing Dashboard .PPob 

CodeWarrior comes with a Re$Edit-like program, named 
Conductor, that lets you create and edit PowerPlant-specilk 
resources. The resource we’re interested in in this column is 
the PPob resource. A PPob resource is like a combination of a 
DLOG and DITL, but for any PowerPlant view including 
windows and dialogs. We’ll use Constructor to add a button to 
the Dashboard window. 

Code Warrior 6 ships with two different versions of 
Constructor Though both will do the job, Constructor 2.0al6 is far 
newer than Coastruetor 1.0.1 and seems pretty stable for an alplia 
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release. Ihe screen shoes and instructions in this column were all 
leased on 2.0al6. You’ll find both versions in the CodeWarrior 6 
folder, inside the Metrowerks Power Plant subfolder. 

* Launch Constructor 2.0al6 and open the file 
Dashboard.PPob (it’s in the same folder as the two 
Dashboard project files). 

As you can see by the Constructor window shown in 
Figure 2, the file Dash board, PPob already contains a resource. 
This PPoh resource represents the main Dashlx)ard window, Tt 
has a resource ID of 200 and represents an object belonging to 
the class LWindow. 





——-—■ Dash board. PPob 
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Figure 2. We Constructor window listing 
the tHetv resources in Dash board.PP0b . 

Our next step is to edit this PPob resource. 

* Double-click on the LWindow PPob with an id of 200. 

When you double-click on PPob 200, a PPob editing 
window will appear (see Figure 3) showing the object view 
hierarchy defined by this PPob. Right now, the PPob consists 
of a single window. 



Figure J, A Constructor window showing PPob 200. 


If you click on the window view and select Pane 
Information... from the Pane menu (or just double-click 
on die window view), a pane info window will appear (see 
Figure 4) allowing you to edit the selected view. In this case, 
the selected view desertbes a document window with a zoom 
box, no close box, positioned automatically in the Alert 
position on the main screen, etc. Feel free to edit this view if 
you like. To test your changes, quit Constructor, saving your 
changes, then use CodeWarrior to rerun the project. 



Figure 4, 7 he Pane Info window describing the Dashboard window. 
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Figure 5. We items you can place in a window using Constructor. 
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With the PPob 200 window in front, you should notice a 
palette window listing ail the items you can place in a PPob 
view. The palette, shown in Figure 5* works just like ResEdit's 
DHL palette. To add an item to a view, drag the item off the 
palette into the PPob window. 

Here's where we’ll add the burton to the window. 


contain the PowerPlant classes that implement push buttons; 
LControl * cp and LStdControl . cp, 

* fn the project window, click on the triangle to the left of the 
group named Pane, When we add the two files, we want 
to add them to this group. 


* Drag an LStdButton off of the palette into the window 
view in the PPob 200 window. 

* Double-click on the button Urn appears and edit the inlb 
window to match the one shown in Figure 6. 


* Add the files LControl .cp and LS tdCont rol ■ cp to 
the project. You'll find them in the folder “CodeWarrior 
6:Metrowerks C/C++:PowcrPIant LibrariesiPane Classes” 

CDashboahdAppji 

* Open die file CDashboandApp.h. 


LStdButton (IB = 1000) 


Left Edg*: [ E^B| Vidib: jS9 | 0 Enabled 

Top Edge ; |l01 | Height: |20 | El Visible 


Pane ID : |lQOQ | □ Text ID 

Class ID : |phut 

User Constant: (o | 


□ Bind Left Edge 

□ Bwid Right Edge 

□ Bwid Top Edge 
|~| Bind Bo Horn Edge 


Button Till*: 

Beep 

Value Message : 

1000 

11 J Text Message 

Text Traits [O: 

5 1 

Control Kef c*»: |o 
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Figure 6. Ibe info window for the LStdButton we added to 
our window mew. 

There are three Important changes to make in the 
LStdButton info window. First, change the Pane ID: field 
to read 1000 (be sure the Text ID checkbox is unchecked 
before you change the ID), The Pane ID serves to identify the 
button pane from all the oilier panes in the PPob resource. By 
convention, number your panes seining ai 1000 and moving 
upwards from there. For example, if you added three items to 
the Dashboard window represented by PPob 200, you’d set 
their Pane IDs to 1000, 1001, and 1002. 

The second change to make to the LStdButton info 
window is to fill in the Button Title: field. Since we warn our 
button to beep, the word Beep will make a fine button title. 

The third change is to the Ualue Message: field. This 
field contains the message rhai will get sent when the button is 
clicked. The message is an integer constant that will lie passed 
as a parameter to any objects registered as listeners to the 
broadcasting burton. Again, by convention, well number our 
messages starting at 1000. 

That's it. Save your changes and quit Constructor. 

Dam lift )ahd68K.|i or DashroardPPC.|i 

If you haven’t already, open up one of the Dashtmrd projects 
(either Dashboard68K,|j or Dash board? PC, p). Since we want 
to add a button to our window, well need to add the files that 


* Add this line after the ^include of <TApplicaLion.h>; 
tfinclude <LListener.h> 

* Change the firsL line of the CDashboardApp class to look 
like this: 

class CDashboardApp : public LApplicatIon. public LListener ( 

To convert the CDashboardApp class into a listener, we 
have to make sure it is derived from the class LListener. 
Deriving a class from more than one class is perfectly 
acceptable in C++ and is known as multiple inheritance. 

Another step in making the CDashboardApp class a 
listener is to add a member function named 
ListenToMessage (). ListenToMessage () will 
get called when any broadcaster ii is listening to broadcasts 
a message, 

* Arid this line after the definition of the member function 
FindCommandStat.us (): 

virtual void ListenToMcssagfi{KesEageT inHessage. void 
'ioParam); 


* Close CDashboardApp.!) and save your changes. 

CDashboakdApp.cp 

Here's where all the action is. Take some time to look through 
the file and read all the comments (don't worry, the file isn’t 
that long). Notice that rnain() defines a CDashboardApp 
object and then calls the menilxrr function Run () which was 
inherited from the ^Application class. 

* Add tills line after ail the other ^include files- 
jfinclud* <LStdControl,b> 

Notice that even though we added the files 
LStdControl. cp and LControl, cp to the project, we 
don't include the Ole <LControi,h>. <LControl.h> is included 
by <LSidControl.h>. 

* In the constructor, find the call of the static function 
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URegister: :RegisterClass {) and add this line 
right below it: 

^Registrar:: RegistetClase (LStdButton:: ciase_ID. 

LStdButton;;CreateStdButtonStream): 

This line tells PowerPlant which function to call 
(LStdButton::CreateStdButtonStream()) when 
an object of type LStdButton Is created based on a PPob resource. 
Before we came along, this program only needed to register the 
LWindow class. Since we added an LStdButton object to the 
PPob resource, we'll need to register that class as well. 

* Also in the constructor, just before the call of 
mDisplayWindow >Show() T add these lines: 

LStdButton *theButton - 

(LStdButton *)mDisplayWindow >FinHPjiricBylD( 1000 ); 
theButton >AddListener{ this ): 


The First line searches the window mDisplayWindow for 
the pane with the id 1000. Now you know why we entered the 
number 1000 in the LStdButton's Pane ID: field. 

The second line registers the current object Cl he 
CDashboardApp object, known here as this) as a listener of the 
button we just found. 


* At the end of ihe file, add the member function 
CDashboardApp::ListenToMcssage{}: 


U - -.. .-. 

fl * LifftenToMessage 

//...---.—- 

//Respond to message 1000 broadcast by pushbutton 

void 

CDashboardApp: :ListenToMessag,e(HessageT inHessage, void 
“ ioParam) 

1 

if ( inHessage -*■* 1000 ) 

SysBeep£ 20 ): 

I 


This function will get called whenever the button is clicked. 
The message 1000 will be passed in as the parameter mMessage. 


Figure 7. Ibe Dashboard window. Ibis time it has a button in it. 

Running the Program 

That's about it. Save your changes anti run the program. The 
usual Dashboard window will appear, but this time with a 
button smack-dab in the middle of it Press the button and, 
guess whar, your Mac will beep at you. 



Till Next Month 

Obviously, this month's program gives you only a brief glimpse 
into the PowerPlant framework. On the other hand, it's a 
pretty solid glimpse. Try your hand at adding some other 
panes to the Dashboard window containment hierarchy. Stan 
by adding a second button with its own pane ID and its own 
message ID. Next, try to add some other controls. 

What part of PowerPlant would you like to learn about 
next? Should 1 gel into other control types? How about 
(shudder) menus? Send email. I ll he wailing to hear from you. 
See you next monih.,. 
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Fast remote internetworking 
in a single box. 


► E-mail 


► Shared Access to the Internet 

Your whote department or organization can connect to 
the internet—full time or just when you need to. 


Streamline communications 
with enterprise-wide E-mail, 



► Telecommuting 

High speed access to 
the entire office network 


Centralized Databases 

Access or update information 
from any point on your Wide Area 
Network. 


Exprasnftouttif ISDN 


^ Videoconferencing 

Close the gap between 
distant sites with LAN-to-LAN 
videoconferencing. 


EnpressRouiers 
with Integrated 
Interfaces 


Fast File Transfer 

Transfer files at speeds up to 
1.544Mbps—10 MB per minute. 


What makes the ExpressRouter the best choice for your Wide Area Network (WAN) needs? 

* Built-in WAN interfaces for Frame Relay , ISDN, Tl, and 56Kbps DOS, 

* Expandable architecture that supports up to 3 high-speed WAN ports. 

* Built-in support for AppleTalk, TCP/IP and Novell IPX LAN protocols, 

* Interoperability via PPP. 

* Support for SNMP and Telnet management standards. 

* Powerful, easy-to-use auto-dialer software designed for the Macintosh. 



Engage Communication, Inc. 

9053 Soquel Drive • Aptos, CA • 95003 

Tel: 408.688.1021 • Fax: 408.688.1421 • E-mail: sales@engage.com •WWW: www.engage.com 









WE HAVE A FEW QUESTIONS FOE YOU ... 
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0 Which Macintosh copy protection key is committed to uncompromising technological superiority • 

9 2 3 4 5 6 

0 Which key is the best selling Macintosh key in the world • 


0 Which key was developed by Mac developers, and is the first and only 100% ADB savvy key • 


0 Which key offers you the most sophisticated network protection available anywhere 



9 ' 

0 Which key delivers developer support response within 24 hours • 


9 ‘ 

0 Which key has now surpassed its own technological lead, actually improving on the best • 

THERE IS ONE ANSWER... 

0 ™ 

MICROGUARD^ 



For more information and to order a Developer's Kit or to receive a free CD ROM about , 

MicroGuard, please contact us at: WRf 1 

MicroGuard USA: Tel: (303) 320-1628 • Fax: (303)320-1599 • AppleLink: M.GUARD 

International: Tel: (972-3) 558-2345 • Fax: (972-3) 558-2344 • AppleLink: MICROGUARD MaC'OS 


1, "Technology at its peak" is our commitment to you, and that is why we have actually improved the best key available and brought you 
MicroGuard Plus™ which is 100% backwards compatible with MicroGuard, just as we promised it would be. 

2, We estimate that 70% of die Mac keys sold are MicroGuard keys. 

3, We have been developing Mac applications as a seed development house since 1984, We tire not a PC company that has come to you 
with a Mac product. Back when other keys clashed, MicroGuard was fully ADB savvy and offered extended addressing, Onty 
MicroGuard offers this level of sophistication. 

4, Our network protection, MicroGuard Net™, is so superior, we had to hire an Apple network engineer to execute our specifications, 

5, We guarantee 24-hour response to your inquiries. But we don't get many, anyway. We have a fully loaded bulletin board on AppleLink 
under Third Parties that contains all our libraries, tech notes, Q&A and nearly everything you'll ever need, 24 hours a day! 

6, MicroGuard Plus is everything MicroGuard is, plus 40-bit encription, four passwords, a 45% si/e reduction, 64-Bit Array, 32-byte public 
area, enhanced counter and more. Plus two new utilities, QuickGuard™ and EasyGuard™. which allow you to MicroGuard protect 
your applications in minutes without touching your source code. The only feature that is not plus is the price. >) 
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TECHNOLOGY 


By Kent Sandvik Apple Developer Technical Support 



QuickTime and Offscreen GWorlds 


Manipulate QuickTime 
video frame by frame . 


Xhis article explains how to w r rite 
QuickTime video frames (samples) lo 
offscreen GWorlds, and blit tliese frames 
back to the main screen, while avoiding 
flickering and frame drops if possible. The 
techniques shown should provide you 
with the information needed to implement 
various applications that manipulate 
Quick' lime video frames offscreen. 

For instance, you may want to draw 
something on top of each QuickTime 
frame displayed, as quickly as possible. 
Or you warn to modify a movie's 
pixmaps lieforc they are displayed. In all 
cases, we don't want any flickering due 
to redrawing. 

You may want to step through each 
video frame one at a time, modifying the 
frame's pixmap, and you are not 
worried abouL frame drops or other time 
critical conditions. In other words, it is 
fine for you to browse and modify 
frames at your own pace because the 
QuickTime movie is not playing. 

Maybe you want to be informed 
every time QuickTime has drawn a 
frame, and perform additional 
operations unrelated to the frame itself. 
In other words, you are not interested in 
the actual GWorld of the movie. 

We will cover these three cases; 
how to draw to an offscreen pixmap 
{remember, QuickTime works only with 
32 bit Color Quickdraw), modify the 
contents and blit this back to the main 


screen as quickly as passible; how to display and change frame 
information one frame at at time without playing the movie; and 
how to be notified when QuickTime has drawn a frame. The 
sample code also has functions that measure the slowdown that 
additional drawing imposes on playback, and measures how 
long the drawing operations lake. 

Wc assume that the reader has basic knowledge about 
GWorld and GopyBits techniques. 

Fast Video Frame Drawing 

When a QuickTime movie plays, it is of utmost importance that 
as little as possible is happening beside displaying movie 
frames on the screen. Time spent doing other activities will 
provide fewer CPU cycles for QuickTime to read, arrange and 
display media samples. If die application spends time doing 
additional activities, it will directly impact the QuickTime 
movie's playback performance. 

So, whatever we do when we annotate the video frames, 
we T d better do it quickly. The less we do, the better. 

QuickTime will always use only one GWorld for drawing. 
Most importantly, it uses this single GWorld for decompression 
purposes, building pixmaps based on sample information in the 
video track. For instance, if we are dealing with a 
decompressor Lhat understands temporal compression (where 
only the changes from frame to frame are recorded), the 
pixmaps are built using temporal information, and QuickTime 
will not redraw every pixel in the GWorld, This means that we 
can t draw directly on top of existing QuickTime video frame 
information. If we do, our drawing information will be retained 
in the GWorld, not erased at all, and wc get the dreaded 
"smearing" effect. 

In order for us to control the drawing, or have access to 
the specific GWorld that QuickTime is using, we need to detour 
QuickTime to use a known GWorld. We can think in terms of 
layered drawing environments. We also want to be informed 
when the frame is drawn into this GWorld. When we're 
informed by QuickTime, we can manipulate the GWorld 
contents, or blit the contents back to the mam window port and 
then do our drawing operations on top of the copied image 
(this is a layer oriented approach). 

To avoid flickering, wc need to copy the original video track’s 
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Joe Zobkiw 



by Apple Computer, Inc. 

Now you can incorporate spectacular 3D graphics 
into your applications. This book/CD-ROM package 
explores QuickDraw 3D, a graphics extension to the 
Mac OS for Power Macintoshes. The CD contains the 
complete QuickDraw 3D system itself and o com¬ 
plete database of the QuickDraw 3D API, allowing 
you instant access to Ihe hundreds of graphics calls 
via □ fast viewing engine. 

Book/CD-ROM, 640 pages 


by Joe Zobkiw 

Here's some practical help for creating 
code resources and code fragments for the 
Macintosh and Power Macintosh. Rather than 
gathering and indexing code, the author teaches 
you more about how the Macintosh system 
functions as a whole. He also provides hard to find 
information about techniques used To structure and 
build lot, safe fat, and accelerated code resources 
for use an both &dOx0 and Power Macintosh. All 
code is reusable and is provided on the disc, along 
with Metrowerks Code Warrior Lite* 

Book/CD ROM, 528 pages 


by Richard O. Parker 

Now that Symantec's long-awaited PowerPC-native 
compiler is here, developers ore taking another 
look al THINK. This book provides a thorough 
examination ol Symantec's extensive Class Library 
and the Visual Architect, a graphic user interface 
development tool that allows you to produce 
commercial-quality applications with a minimum 
of effort. Visual Architect tutorials provide you with 
a step-by-step approach for simplifying the 
development of complex Macintosh applications. 
496 pages 



by Danny Goodman 
and Jeremy Joan Hewes 

Two highly respected experts offer □ different 
approach for creating your own Apple Guide 
databases. With this program, you can make 
guides quickly and easily, without having (o 
learn a scripting language, write coded fries, or 
use several different files and programs to pro¬ 
duce your database. The authors provide advice 
and tips on how to design a good Guide, from 
planning through testing, revising, and indexing. 
Book/disk, 320 pages 
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• Uy Apple UsntiJUier fm CD-ROM 


by Apple Computer, Inc. 

Have you ever needed to find current information 
about using a crucial toolbox call while in the 
middle ol writing your application? Now with just 
a click of your mouse, you can get inslant access 
to more than 5,000 toolbox calls. This CD-ROM 
data hose contains all routines, data structures, and 
constants as documented In inside Macintosh* With 
a lightening fast search engine, it helps you find 
key data structures, resources, constants, and 
functions when you need them the most. 
CD-ROM 


by Apple Computer, Inc. 

For those who want the full power of Apple's 
complete toolset, this book and CD-ROM pack¬ 
age from Apple provides everything you need to 
produce guide files successfully, including Guide 
Maker, ihe software you use to build and test 
guide files. You'll feom about the complete 
cycle of designing as well as advanced topics 
such as scripting and coding guide files. 
Book/CD-ROM, 544 pages 
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OPTIMIZING 

PowerPC, 

CODE 

Programming the 
PowerPC Chip ih 
Assembly Language 


Gary Kacmarcik 


by Gary Kacmarcik 
To lake lull advantage of the speed and fea¬ 
tures of the PowerPC chip, you need lo master 
assembly language techniques. Written by an 
expert in the area, Optimizing PowerPC Code 
provides hard-core, cross-platform help at the 
assembly language level Even if you have I title 
need to write a significant amount of code in 
assembly language, the techniques presented 
here wilt be helpful in reading compiler* 
generated code and in the debugging process. 
704 pages 



by Apple Computer, Irre* 

How the 25-book Inside Macintosh series is 
available on one CD. The Inside Macintosh CD-ROM 
contains the electronic text for 25 hooks from 
inside Macintosh—the essential resource for 
programmers, designers, and engineers. You can 
have instoat access to more than 16,000 pages of 
information contained in the inside Macintosh 
suite, including the QuickDraw GX library* 
CD-ROM 



PowerPC 

System 

Architecture 




PCI 

System W 
Architecture 



by MindShore, Inc. 

This book describes the hardware architecture 
of PowerPC systems, providing a dear, concise 
explanation of the PowerPC specification, the 
template upon which all PowerPC processors 
are designed* The author provides a complete 
description of the specification for both the 
32- and 64-bit implementations* 

656 pages 


by MindShare, Inc* 

Describing revision 2.1 of the Peripheral 
Component Interconnect (PCI) bus specifica¬ 
tion, this hook explores PCI's relationship to 
the rest of the system. It includes an in-deplh 
treatment of PCI to PCI bridges, the PCI BIOS, 
the 66MHz PCI bus, and more* 

592 pages 
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GWorld contents to another GWorld, do our drawing in tins 
second GWorld, and then finally blit this GWorld piximp to the 
main screen. This sounds like a lot of work, but you can run tests 
to measure if performance is suffering from two CopyBits calls. 

QuickTime L6 introduced the a method to specifying 
which GWorld a track will be drawn into. The function 
SetTraekG World takes a specified GWorld we have created and 
Lei Is the QuickTime toolbox to draw a specified video track into 
a specified GWorld, In addition, with SetTraekG World, wc can 
specify that a specific callback function is called when a frame is 
transferred from a track into this GWorld. When this track 
transfer callback function is triggered, we can do additional 
graphics operations on the frame pixmap (or anything else). 

As long as we don’t spend too much time inside a track 
transfer callback, copying from a specified GWorld back to the 
main screen is reasonably fast. However, we need to always 
worry about speed. The more work we do before the 
operation, the better. For instance, we should preallocate any 
buffers, handles and anything else that does not change 
dynamically during a track transfer callback. Memory allocation 
may take more time than expected, especially if the Memory 
Manager needs to compact the heaps in order to find memory 
blocks of required size. 

Similarly, rhe less work we do inside the callback, the better. 
As we will use CopyBits at the end of the track transfer callback, 
it is important to know how to optimize the CopyBits function. 

Prealloc nation , Pkecalci uation 

Before the track transfer callback we create the needed 
GWorlds and other buffers, and also try to precalculate any 
values that we know won't change while we are inside the 
track transfer callback. To some degree smart compilers will 
also optimize away unnecessary operations, but ii makes sense 
to do this ourselves as well 

For example, we want to calculate how far we are into the 
movie based on how many frames have been drawn. We need 
the total duration of the movie for the calculations; wc can't 
avoid the fad that we need to calculate the value inside the track 
transfer callback. However, we could store away the duration 
value of the movie before the track transfer callback is operating. 

CopyBits Optimization 

CopyBits optimization is very well documented in the Tech 
Note tL QD21 Of Time and Space and jGopyBits”. Here’s a short 
summary, a comparison of the techniques covering our 
example of QuickTime video frame blitting:. 

We should try to copy the smallest possible area; the less 
bytes CopyBits need to move, the better Now, in the case of 
QuickTime movies with defined movie box dimensions we 
can't avoid Lhis, we need to copy the whole area from the 
GWorld to the final destination. However, if wc know we want 
to copy parts of the movie, we could cheat and just copy the 
rectangular area we are interested in. 

In most cases we use the srcCopy mode when copying 


video frames from the offscreen to the main port, and this is the 
fastest transfer mode. Using other modes, such as transparent or 
blend mode, will slow down the copy process considerably. 
Note that adding the dither mode will really slow down CopyRirs. 
Various codecs, such as Cinepak, will dither anyway (fiom 24 bit 
mode down to 8 or 16 bit depth of the monitor GWorld), 

lr makes sense to specify the background and the 
foreground colors for the current port, so that the background 
color is while and the foreground color is black. This will 
provide a hint to CopyBits so that it won’t do colorizatlon 
operations while copying information. We also assume that the 
GDevice pixel map’s color table has white in the first position 
and black in the last position (this is the normal setup of a 
Macintosh color table). 

The alignment of pixels in the source pixel map is also 
very important. If CopyBits needs to realign the pixels it will 
slow down the copy process considerably. For instance, 32-bit 
CPU environments are at their fastest when they can transfer 
long words aligned on long-word boundaries in memory. This 
is the reason why AlignWindow is a very- important QuickTime 
call; AlignWindow will move the specified window to the 
nearest optimal alignment position on the screen (or screen 
video memory position). This means that if this is done with 
the destination GWorld, then CopyBits will operate very fast. 
QuickTime movies are mostly also aligned for four-byte values 
(movie rectangle dimension are divided by four) so this will 
help as well. If die movie does not have this property (check 
this with for instance MoviePlayer), then it’s time to re-crop the 
movie so that we have such sizes. Sometimes cropping of the 
original movie might cause odd sized movie rectangle values. 

We should also, if possible, use the smallest pixel depth. If 
we want to operate in 256 color mode we should stick to 8-bit 
pixel depths. Note that various QuickTime codecs arc 
optimized for various pixel depths. For instance, Cinepak is 
optimized for 24-bit color mode, and it will dither to 16 and 8- 
bir screen depths. One issue is if we should stick to the 
original image depth of the movie and build a GWorld based 
on this pixel depth, and then later copy from this GWorld to 
rhe monitor bit depth GWorld. Or if we should create the 
offscreen GWorld with the same bit depth as the monitor bit 
depth, The sample code has both approaches so you could do 
more thorough tests to narrow down what case is the fastest 
one in your application. 

We should also stick to die same source and destination 
rectangles so that CopyBits does not need to scale the copied 
image. In most cases we want to use the movie box 
rectangle sizes, as wc want to blit Lhe whole movie back to 
the monitor window. 

Color QuickDraw expects a color table attached to every 
indexed pixel map (8 bit mode). Color tables specify what 
color cadi pixel value in the pixel map represents. Color 
QuickDraw often uses the ctSeed field of the color table data 
structure as a fast check for color table equality. If two color 
tables have the same ctSecd, then Color QuickDraw often 
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Cross-platform multimedia database technology for professional developers 


CXBase Pro 

A powerful ANSI C database engine for 
C and C++ programmers 

Based on the database engine used by Apple AOS for their 
eWorld content publishing software, CXBase Pro represents the 
state of the art in data storage and retrieval technology. 

CXBase Pro has all the tools you need to develop any kind of 
application that needs its own database engine. 

The philosophy behind CXBase Pro is to provide a simple, 
consistent, and powerful API that lets you work in whatever way 
you choose CXBase Pro is delivered with full source code, giving 
you maximum flexibility and security. CXBase Pro is completely 
cross platform, allowing you to access one set of files from any 
platform. And CXBase Pro has been engineered from the ground up 
for maximum performance. 


The AMTCX 
Database Extension 


An integrated, cross-platform database engine for 
the Apple Media Tool Programming Environment 

The AMTCX Database Extension is a set of classes for the 
Apple Media Tool Programming Environment that give you 
access to CXBase Pro. The classes let you store traditional record 
and field-based data, as well as multimedia data. All the 
programming is done using AML, making it very simple to use 


More and more developers are discovering that 
database-driven titles can solve many run-time 
and production problems. The AMTCX gives you 
the ability to create these titles. The AMTCX 
also includes a full version of CXBase Pro. 


Check it out on the 
Apple Media Tod 
1 2 Demo CD! 


Test drive before you buy - Full-featured $49 demo available! 

Both products come in a demonstration version, including the complete manual, a full-featured library limited only by file size, and access 
to all the function calls. You can use it as long as you like, and if you decide to buy the full package you get credit for the price of the demo. 


TSEInternational i Taandwarsstr. 51 i 1013 BV Amsterdam, Holland » tel: 31 20 638-6507 fax: 31 20620-4933 > AppleLink : TSE INI 

Apple, AOS, eWorld, Power Macintosh, and Quadra are tradomarte ot Apple Dompcuor, Inc 


assumes that their color table contents are equal. We could 
make use of this feature and copy the ctSeed value (long word) 
from the original color table to the destination color table, and 
UiLs way Copy lilts assumes that die two color tables are identical 
and will copy the pixels directly without any color mapping. 
This will improve Copy Bits performance in 8-hit mode. We will 
copy the existing color table from the GDevice, and use it to 
create the two offscreen GWorlds. 

It also makes sense to make an estimate about the slowest 
platform the application Is aimed for. This way we will know if 
our offscreen operations will work properly for a targeted entry 
level system or not. One cardinal sin is to implement most of 
the application using a high performance PowerPC development 
system, and then do the system testing using a low perfomiance 
CPU system. If possible test out the grapliics drawing ideas 
with low end machines before you complete the project. 

Setting up top Track Transfer Proc 

The basic code we use for setting up the test environment 
creates a window, gels a QuickTime movie from a file, adjusts 
the movie box (rectangle) values, and makes sure that our 
movie GWorld points to the window port, or: 

SetMovieGWorld(gKovie, (CWorldPtrigWindov. NULL); 


After this we fetch the duration of the movie and find die 
first suitable video track. Most QuickTime movies have just 
one video track, so w'e assume that this is the case in this test 
application. We also fetch the pixel depth of the movie using a 
specific call from the QuickTime utilities function library (more 
about that at the end of this article). Or we could get the 
monitor bit depth from the monitor GDevice structure. Note 
that in to speed things up, we have left out the error testing 
code in the example: 

gMovleDuration = GetMovieDiiration(gJfc>vie) ; 

firstVideoTrack - GetMovielndTrackTypet^Movie, 1, VldeoMediaType, 
movieTrackMediaType): 

firstVideoMedia =■ GetTrackMedia{firstVideoTrack); 
mediaPixelDepth = QTUGetVideoMediaFlxelDepth(tirstVideoHedia, 1); 
monSTorPlxa]Depth * (*‘(**a£avedGDevice).gdPHap)♦pixelSize; 

Then we create our GWorlds we will use for the offscreen 
handling (one for the video track redirection, and one for the 
final composition), use SetTrackGWorid to redirect the GWorld 
drawing to a specified GWorld, and also install the callback: 

//nmc that munitorDept = 0 implies default monitor depth 

anErr = NeidGWorldC&gTrackGWorld. monitorPixelDepth, SgHovieRect, 
dolorTable, gTradkGDevice, 0); 

anErt “ Nt'wGWorldf&gCoitipaneGWfTrld* mtmi tor Pixel Depth, igHovieRect* 
colorTable, gCooposeGDcvlce, 0}; 
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F A C E S PA 


Try ourfreedemo version of FaceSpan. ftp://facespan.sdu.coni 


SOFTWARE 

DESIGNS 

UNLIMITED 


Price: $199,wh(chincludesa 
royalty-freedistribution license for 
unlimited runtime users. 

Phone:800-FaceSpan 
International: 214-578-6700 
Fax:214423-5360 
Email: FaceSpan@StXJ.com 


The perfect companion for AppleScript™. 

When your users are clamoring for a newtn-house application, 
you don’t have time to code from scratch in a traditional 
programming language like Cor Pascal, But, with FaceSpan™ 
v2 you can take advantage of the flexibility of an interactive 
visual interface design tool, combined with the power and ease 
of useof AppleScript or any OSA language. 


Nowyou can integrate any scriptable applications with your 
FaceSpan programs. Create the custom sdutionsyou need 
without reinventing the wheel 

* Develop integrated solutions from other scriptable apps. 

* Makestand-alone applications that can be distributed 
royalty-free. 

* Create friendly interfacesand powerful command 
centers. 

* Develop detailed prototypes rapidly—get instant 
feedback from users, and avoid hours of recoding. 


SetTrackGWnrld [f 1rstVldeoTtack. (CGrafPtr)gTrackCWorld. 
gTrackGDevice* 

SewTrackTransferProc (MyTrackTranat'erProc). OL) ; 


We could also specify NULL in place of the GWorld and 
GDevice parameters. This will trigger our track transfer callback, 
but will not do any redirection of the frame display to a specified 
GWorld. We could also use the SetMovieDrawingCompletePmc 
to install a similar callback for this same reason, to indicate when 
a frame has been drawn. 

SetTrafckGtforld(firetVideoTtack, NULL, NULL, 

NewTrackTraneferFroetMyTciickTransferPr-oc), OL); 


Track Transfer Callback 

As mentioned earlier, the less we do inside a track transfer 
procedure, and the quicker we do what we need to do, the 
better The example will show what Lhe estimated frame per 
second rate is based on calculations from the movie itself, and 
after the movie has played it will also show how many frames 
per second were actually drawn. 

In most cases, we will do the normal operations required 
for the CopyBits operation, such as locking down the pixmap 
handles before CopyBits, store away the current GWorld that 
we will restore later, and switch over to the new GWorld. Note 
that when we enter the track transfer callback, the valid GWorld 
is the correct destination, not the GWorld we specified for the 
track transfer operation: 

offsereenPixMap ® GetGWorldPixMap£ {GWozldFtr)gTrackGWorld ); 
if (tlnckPixels{t rackPixMap)) goto Closure: 

offscreenPixMapZ = GetCtforldFixMap{ (GWorldPtr)gCoitposeGWorld); 
if (ILockPixeisCcomposePixMap)} goto Closure; 

GetGWorld(&aSavedPort. kaSavedGDevice}: 

SetGWorld( (CGrafPtr)gCompnseGWorld, NULL): 

Now we copy from the GWorld to the composite GWorld. 
Before Lhat we make sure that the foreground and background 
colors are set to black and white: 

ForeColor[blackColor}; EackColor[whit cColor]; 

CopyBits( (EitMap 0 *lrackPixMap. (BitMap *) •composePixMap, 
fcgMovieRect. kgMovieReet, srcCopy, NULL ); 


After this we will do the needed drawing operations by 
drawing to the composite GWorld, for example: 

PenSize(I.1): 

ForeColur(whiteColor) ; 

frameKect [&gTiraeDurationftett): 

percentage = 1QQL * GetMovieTimetgMovie, NULL) / 

gMovieDuration: 

MoveTo{ 5 . 5 ); 

ForeColor(yellouColor); 

PenSlze (4 , 4 ); 

LineTot percentage +SL, S); 


This will produce the layer effect we wanted. In other 
words, QuickTime will draw to the offscreen GWorld. 

Finally we blit this composite offscreen back to the main 
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dtF 


The Relationa 
Database Syste 


When it comes to performance dtF is in a class all its own. dtF utilizes a proprietary query 
optimization and caching scheme to obtain unparalleled performance. And if you are in need 
of a quantum leap in performance, use the dtF native PowerPC standalone or server version. 

Full transaction control and error recovery guarantee maximum data protection even after 
sudden system crashes. dtF databases are compressed and encrypted to protect against all 
unauthorized access, even disk editors. 

Integrated data dictionary, security, automatic index selection, query optimization, deadlock 
detection and error recovery allow you to concentrate on your application. The dtF API 
was designed for a seamless integration with third-party toolkits and class libraries. 

dtF features include SQL, BLOB support, electronic documentation, sample applications, 
tutorials, and tools for importing, exporting, creating, managing databases and users. dtF is 
currently available for Macintosh, DOS, Windows, OS/2. The C/C++ API is identical 
across all platforms. 

Available for Macintosh System 7.x and native PowerPC. MPW C/C++ (68K and native PPC), 
Symantec C/C++, Metrowerks CodeWarrior (68K and native PPC). Separate versions for use with 
HyperCard, SuperCard, SmalltalkAgents® and Prograph CPX available. 

Standalone applications built with dtF are royalty-free. 

dtF Americas, Inc. 

19672 Stevens Creek B1 vd.. Phone: (800) DTF-1790 
Suite 128 Fax: (510)828-8755 

Cupertino, CA 95014, USA AppleLink: DTRAMERICA 
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aii TEy$ is 

not created 
equal. 


Ls your application tak¬ 
ing cut & paste a little too 
literally when it creates text? 
Does your text look like it 
was created on a ten year 
old mainframe? Then you 
need PAIGE . Data Pa k 
Software's latest multi-plat- 
form text editor and page 
layout programming li¬ 
brary. 

PAIGE helps you pro¬ 
vide the most sophisticated 
features/fu notions in the 
business. Including: 

• Portable C Code 

• Stylized Text 

• Text Wrapping 

• Embedded Objects 

• Shapes/Containers 

• Virtual Memory 

• Style Sheet Support 

• Multi-lingual Capable 

• Royalty Free 

HUGE is written in por¬ 
table C and uses no global 
variables. Machine specific 
code is minimized to en¬ 
sure a consistent APr for all 
p la tfo rm s—s i m p I i f y i n g 
multi-platform develop¬ 
ment. This strategy allows 
you to move your applica¬ 
tion to other platforms 
while maintaining data and 
a ppl tealk»n a >t n pat i b i I i ty. 


PAIGE overcomes 32K 
and 64K segmentation bar¬ 
riers. Built-in virtual 
memory, combined wish 
high-performance, makes 
this technology a valuable 
replacement for all exist¬ 
ing “text edit” technology. 

To help get you started, 
both the Macintosh and 
Windows libraries ship with 
hill source code for the 
demo application. 

So why should you buy 
RAIGE for your next 
project? 

TIME. Programmers 
can’t afford to reinvent the 
wheel when implementing 
advanced text features 
within their applications. 

"Buying fWGE was tike 
adding another devel¬ 
oper to the team ” 

Win Logan, 

TDS Health cate 

Join ihe hundreds of de¬ 
velopers worldwide using 
RAIGE as their total text 
solution. For a complete 
technical and pricing sum¬ 
mary, or to request our 
product demo, contact the 
DSI sales department to¬ 
day at 800-327-6703 


DATAPAK SOFTWARE INC. 

9317 NE Hwy 99 #G • Vancouver, WA 98665-8900 
Bus: (360) 573-9155 • Fax: (360) 573-9269 
Internet: 76424.3027 @ compuserve.com 
AppleLink: 00142 • AOL: DATAPAK1 • CS: 76424.3027 


window, then restore the GWorlds and unlock the offscreen 
ptxmap handle, and return. 

SetGWorldt (CGrafPtr)gWindov, HULL 
ForeColor(blackColor); BackColor(vhiteColor); 

CnpyBitsC (BitHap *) ‘composePixMap* 

(EitMap *) &g¥indow->po r tPixMa p, 

&gMovieRect, GgHovieRect, BrcCopy, NULL J; 

SetGWorld(aSavadPort, aSavedGDcvlce}; 

UnlockPiKelsCcjfffjr reeFiPixMap): 

UnloekPixels(offscreenPiKMapZ); 

return anErr; 

Frame by Frame Drawing ro Offscreen GWorld. 

Tliis second technique shows how to draw individual frames to 
an offscreen GWorld and blit the.se back to the main screen. In 
this case we are not worried abouL drawing speed, so we can 
afford to write a more generalized, self-conLained function that 
can l>c called, on demand, from many contexts. The function 
will both set up the GWorld environments, draw, and tear down 
the created offscreen GWorlds, We can also afford more 
extensive error testing to make sure that this function will signal 
any kind of odd behavior. 

In diis example, we create a transitional effect between two 
frames. The frames are specified by two time values. The 
effect is drawn in offscreen GWorlds. 

Our function will begin by querying the movie's GDevice 
for the bit depth and color table information. Then, using this 
information, we cal! NewGWorld twice to create two separate 
offscreen GWorlds. Then we redirect QuickTime to draw into 
one offscreen GWorld, set the movie to the desired time value, 
and force an update of the movie frame (sample). We do the 
same thing with the second GWorld using the second time 
value. After this we could do various other operations. In the 
example we will scroll in the first frame to the left and the 
second frame is scrolled in from the right. Inside this scrolling 
loop we initially blit to Lhc second GWorld from the first to 
create the scrolling transition effect, then we blit the second 
GWorld to the main screen. Finally, before terminating, we 
dispose of any used GWorld heap space. 

In this particular case we are not that worried about speed 
(even if speed should always be a concern). Instead we work 
on issues related to the what is happening when the frame is 
drawn offscreen, or what transition effects we could apply 
when we change the frames. 

The CopyRits optimization guidelines, as always, are valid. 
If we want to create a really graphics intensive transition, and 
this transition must happen quickly, then we need to optimize 
the function. For the time being, I like this self-contained 
design, as it sets up all the needed memory allocations and 
releases these every time we call the function. 

Here’s the code. First we do the normal housekeeping to 
store away the current GWorld and GDevice, and we also get 
the pixel sizes and color table for the GDevice that we need 
later when we create the GWorlds: 
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Gives you the Information to Program your Best ! 


The Debugger V2 
& MacNosy 

By Steve Jasifi 



Information 




Control 


T he Debugger is a low and high-level symbolic 
Debugger that runs In a full multi-window 
Macintosh environment. Yon can trace program exe¬ 
cution, view the values of variables, etc. of both 88K and 
PowerPC programs, 

MacNosy is a global interactive disassembler that 
enables one to recover the source code of any Mac applica¬ 
tion, resource file or the ROM, 

When you compare features of the different debuggers, 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program In a full system (6.0x or System 7.x) environ¬ 
ment symbolically! 

It is the only debugger to use the MMU lo protect your 
CODE resources and the rest of the system from the pro- 
gram you are debugging. With MMU Protection you can find 
errors when they happen, not millions of instructions later! 
(Macintoshs with 68030 CPUs only). 

The Debugger is the debugger of choice at: Adobe, 
Aldus, Claris, Electronic Arts, Kodak. MeLrowcrks, etc. 


LlhndoiuRecord^@465520 


14 i ndowRecord 


0 

port 

:CGrafFort J2465320 


108 

windomKind 

: 8 


110 

visible 

: TRUE 


111 

hi M ted 

: TRUE 


112 

goflwayF 1 ag 

: TRUE 

| 

113 

sporeF1ag 

: TRUE 


114 

strucRgn 

: **Regio n _J§488974 


118 

contRgrv 

: **Region J&435534 


122 

upda teRgn 

* *Region J@4859BQ 


120 

w i ndcmiDefProc 

: ^DEF f unRsr c^?8768FG 


130 

da taHand1e 

: t4859?0 


134 

tit1eHand1e 

§485918 * “Untitled-r 


138 

titJeUidth 

67 


140 

§ 

l 

r 

r+ 

MIL 


144 

nex tUindow 

: * W i ndowRecor d_§4652?8 

S 

148 

w j ndowP \c 

: NIL 

152 

refCon 

: $00464F28 



An example of a structured data display irindom 


Its Features Include: 

• Symbolic Debugging of any Macintosh program, ROM, or 
code resource (DRVRs, XCMDs, INITs, PDEFs, 4DEXs 

• Source level debugging for Metrowerks & MPW compiled 
programs (C++, C, Pascal, Fortran, .„), and an Incremental 
Build System with instant link for supcrfasl development 

• Object Inspector for MacApp 3 programs 

• Source level debugging of Think C™ projects 

• Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc. 

• Simultaneous Symbolic debugging of multiple “tasks" 

• Fast Software Watchpoint command to find clobbered 
variables 

• Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Handle Zapping, Heap 
Scramble and Heap Check to detect program en-ors before 
they become disasters 

• Structured display of data (hypertext) with user definable 
structures while debugging 

• Conditional breakpoints to help litter out redundant 
information 

• Continuous Animated Step Mode to watch your program 
execute Instruction by instruction 

• Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps, - 
make it possible to Ferret out the secrets of the ROM, etc. 

• "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 

The Debugger V2 & MacNosy: $350 

Runs on all Macs, Call For Group prices or Updates, 
Visa/MC Accepted. 

Available from: Jasik, APDA, Frameworks or 
ComputerWare (800-326-0092). 


Jasik Designs • 343 Trenton Way, Menlo Park, California 94025 • (415) 322*1386 

Internet: macnosy@jasik.com • Applelink: DI037 
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GetGWnrld(kySavedFort* fcaSavedGDevi Ce ); 

GetMovieGWorld (theMovie, &nov;{©Port, bmovieGDevice): 
screenDepth * {*“(**a£aved0ttovice).gdPMapJ.pixelSize; 
colorTabie - (* *(**aSavedGDeviceJ.gdPMap).pmTable; 

We create two equal CWorlds (including identical color 
tables) for the offscreen writing later, and also lock down the 
pixmaps. 

anErr = NewGWorld UfraneGWoridl, screenDepth, fcmovIeRect, 
colorTable. NUU. Q); 

anErr = NewGWorld {bf rameGWorld2, screenDepthi ianovieRect. 
colcrTable, NULL. 0); 

pixMapI - GetGtforldPixMapf ftameGWorldl): 
if (ILockPixalsEpixHapl)) goto Closure; 
pixMap2 - GetGWorldPixMap(f rameGWorld2): 
if C SLockPfxels(pixMap2)j goto Closure: 

Now we will start drawing; we will set the movie GWorld so 
that it points at one of our offscreen GWorlds, set the rime value 
of the movie to a specified time value (in other words go to the 
time value), update the movie and also call MoviesTask so that 
the movie frame is indeed drawn into the offscreen GWorld: 

SetMovieGWortd CtheMovie. fratoeGWorldl. 

GetGWo r1d DovlceE frameGWo rid1)); 

SetMovieTimeVaiueEtheMovie. mePoint): 

UpdateMovie(theMovie): MoviesTask(theMovie. 0) s 


We will do the same thing with the second frame, but we 
are going to adjust the Lime value of the movie so Lhat this 
other frame is drawn from that particular new time position: 

SetMovleGWorid CtheMovie P frameGWnr1d 2 , 

Ge t GWor Id Dev i c e (f t atpeGWo r 1 d 1 }): 

SetMovieTimeValueUheMovie, toTimePoint) : 

UpdateMovie(theHovte): MovlesTaskttheMovie. 0); 

We want to restrict the drawing by clipping to a particular 
region. In this case clipping to the movie rect makes sense. 
Before that we will create a place holder for the current dip 
region (NewRgn) and we will store away the current clip region: 

elipRegion * NewRgnQr 

Get Cl i p (c 11 pRegion) s CiipRect (intov leRect}; 

The following axle will create the scroll effect. What we 
want to do is to scroll the movie rect nSteps pixels to the left, 
set the rect again, and copybits first from the first GWorld to 
the second one, and then from the second one over to the 
main screen: 

acrollRegion = NevRgnO : 

acreenSize ™ movieRect* right - movieRect.left: 

for (nSteps = 10; nSteps <~ screenSize; nSteps += 10) I 
SetGVorld( frataeGWorldl, NULL ); 

ForeCalor(blackColor); EackColor(whiteColot): 
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NEW Absoft FORTRAN 77 Updates 

New releases of the world’s 
leading FORTRAN for Macintosh 

Absoft F77 SDK v4.1 

Each new release includes: Optimized for Power Macintosh 

• Fully validated ANSI X3.9 native compiler 

• CPU-specific optimizations for fastest execution 

• Compiles up to 5X faster 

• New Absoft Create Make utility 

• Source-level symbolic debugger 

• Two complete graphics libraries 

• MRWF. application framework 

• Full System 7.5 compatibility 

• Latest version of Apple's MPW 



FORTRAN 77 


For Power Mmefnto&h 
i*rtr*ttl Miiuil 


MacFortran II v3.4 

Optimized for Mac II/Quadra CPUs 
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sfessfi 


Contact Absoft for details and upgrade pricing. Academic and volume discounts available. 
Tel: (810) 853-0050 • Fax: (810) 853-0108 • AppleLink: absoft • Internet: fortran@absoft.com 


ScrollRectf&movieRect, 10, 0* aerollRegion ): 

SetRactC&sourceRect, movieRect.1 eft, movieRect.top, 
movieRect.left + nSteps. movieRect.bottom); 

SeiRectUdestinationRect. movieKecl,right - nSteps. 

movieRect* top, movieRect,right, movieRect.bottom); 

CopyBitst (bitHap a ) 'pixHap2. (BitMap *) ‘pixMapl, SsourcdRect. 
&destinat lorikeet, s re Copy. NULL ): 

SetGWorldCaSavedPort, aSavedGDevice); 

ForeColor(blackColor): BackColor(whiteColiic); 

CopyBits( (BitMap *) 'pixMapl* 

(BitMap •) iaSavedFort->port{ , ixMap. 

SmovleRect. fonovieReet, srcCopy. NULL ); 

I 


Finally we will unlock the pixels, restore the dip region, 
restore the GWorld/GDevice environment, and destroy any 
handles we have created inside this function; 

UnlockPixels(pixMapl); Unlock?ixeIs£pixttap2): 
SetCHp(clipRegion); 

if(frameGWorldl !- NULL) DisposeGWorldfframeGUorldl): 

if(frameGWorldZ ! = NULL) DisposeCWorld(frameGVorld2); 

if(scrollRegion !- NULL) DiaposeRgn(scrolIftegion): 
if (clipRegioti t- NULL) DisposeRgn(elipKegiun); 

SetMovieCWorld(theNovie, enovlePorT, movieGDevice); 

SetGWorld(aSavedPort. aSavadGUovire): 

return anErr; 

We could use the function as shown below. 


ScrollToNextVideoSample is the name of the function we 
described earlier, 'l'his is our WaitNexiEventLoop: 

forf;;) t 

WailNextRvont(everyEvent. fcanEvent, 60* NULL); 

if(an£vent.what " mouaeDown) 
break: 

if(anEvent.what = keyDown) I 

GetHovieNextlntereetingTi me. tgMovie, nextTimeMediaSairplo, 

1, kmediaType. gCurrenLTine. 0, igNextTime. NULL); 

if(gNexiTIniP. = 1) break; 

SetGWorld(gWindew t NULL); 

anErr - ScrollToNextVldcoRample(gMovie, gGurrentTime, 
gNextTime): 

gCurrentTime * gNextTime; 

I 

I 


Every time we hit a key we will get one video frame at a time 
using GetMovieNextlnteresiingTime, get the starting point for the 
next value, and pass this one and the current value so that we will 
scroll inside the function from the current one to the next video 
sample. If GetMovieNextlnterestingTime returns -1 it tells us that 
there are no more video samples. Finally we set the currentTime 
equal to nextTime so that GetMovieNextlnLerestingTime has a new 
starting point forward in time. 

The third technique we will describe is how QuickTime 
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FIND OUT FAST 
WHAT'S GOING ON 
IN MEMORY 


THE MEMORY MIKE 


«► See memory allocation in any open heap at a glance. 

Easily spot memory leaks. 

Flags heap corruption when it happens. 

Works with source level debugger to let you find memory problems fast. 
■I* Stress applications on the fly with Purge, Compact, and Zap, 
i* Allocate memory at will for precise stress testing. 

* Log heap data - easily document heap status over time. 

>m No need for source code: nothing inserted in code; no patches 
to the system, 

* Works with 24-bit, 32-bit, and modem memory managers. 

For Macintoshes wilh 6G02G or better Requires System 7 0 or taler 

only $99 US 

Order now from Adianta, Inc, 

Phone: (408)354-9569 * FAX: (400)354^292 
App1eLink:ADfANTA* AGL:Adianta • Intern efcadianta® aol.com 
For VISA. MC, o < American Express orders by mail, lax. oi Apptalink, please include 
name, address, card number, expiration dale, and phone number or email address. 

Also available through the MacTech Mail Order Store, 
tor more information contact 

$}*Adianta f Inc. • 2 N. Santa Cruz Aw. #1201 * Los Gatos, CA 95030 


MacForth Plus & 
Power MacForth \ 


The Language of Innovation is now 
available native on the Power Macintosh. 


FEATURES 

■ Royalty Free Turnkey 
Compiler 

■ Text Editor 

■ Online Glossary Tool 

■ System 7 Compatibility 

■ 68020 Assembler 

■ 68881/2 Co-processor 
Support 


■ High Level Graphics 

■ Toolbox Support 

■ Extensive Documentation 

■ Reasonable Upgrades 

■ Optional Tools Disks 

■ MacForth Plus $199 

■ Power MacForth $199 



CtoUive $othtvfrK*, f+vC. 

4701 Randolph Road, Suite 12 
Rockville, m 20652 

301 -984-0262 or 1-BOO-FORTH-QK (orders) 
Fax: 301-770-1675 Applelink: CSI 


informs you when it has drawn a frame. We can use the 
transfer proe for this; we can also have another callback called a 
MovteDrawingComplelePrtx:. If we install this callback, it will 
l>e triggered every time QuickTime lias drawn a frame. 

We will create a universal Proc pointer for die callhack, and 
then install it using SctMovieDrawingCompleteProc. Note that 
the documentation for this function, available in the QT 04 
QuickTime 1,6 Features tech note, is not complete. This 
function takes four parameters in the Universal Interfaces 2.0, 
and the second one is a flag stating how this callback is 
triggered. The old interface is still honored, but your compiler 
may complain about a problem with the function prototype. 

We have the same implementation issues as in lire earlier 
examples. We should spend as little time as possible inside the 
callback in order to avoid any playback performance degradation. 

1 iere's an example of how to install this callback: 

MovieDrauingCorapIcieUPP gMovieProc: 
gHovieProc “ 

NfivMov i el>cawingComp 1 eteProc (fcMyQTMov icDrawi ngComp 1 eteProc ) * 

So t Mo v i eD r auingCotnp 1 et e P roc ( gMu v i o , 

movieDrawi n gCa 11 WheitChanged * gMovieProc * 0); 

We do the exact same drawing as when we used the track 
transfer proc and the specific GWorld. The difference is that 
QuickTime will use the same GWorld so what we need to do is 
to erase rectangular areas so that our drawing will always draw 
on top of the underlying pixels. 

This technique could also be used for simple playback 
performance measuring. This code is part of the sample 
provided. If you want to calculate how many frames arc drawn 
per second, install a MovicDrawingCompleteProc increase a 
global counter, and calculate the frame rate per defined time 
interval afterwards. 


Debugging 

While writing this axle 1 encountered various situations where 
the code didn't work (of course), or malfunctioned badly, I tried 
to document these cases so that others might learn from my 
mistakes, and avoid potential pitfalls. To speed development and 
debugging, I used a few techniques described below. 

I used many reels in my application, and sometimes the 
difference between the rects are small, but there's still a 
difference. I inserted temporary FrameRect calls here and there 
to see exactly where the reels arc placed inside the Portttect. 

Another concern is keeping track of which GWorld to blit 
from, and where to blit? Sometimes l wrote temporary CopyBIts 
calls that copied pixels from a specific GWorld directly to my 
Window portRect. This way I knew what the GWorld contained 
at a particular point of time. 

DebugStrs are handy if l want to know if a callback is 
really triggered or not. Also, the Metmwerks debugger is very 
good, and there were many times 1 stepped through the 
functions in order to know exactly what happened. 

I do a lot of error testing in my code (left out from the 
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neoShare 


Client/Server 
Object Database Engine 


Collaborative Computing 

NeoShare™ is a collaborative computing engine that object-oriented developers use to create data intensive 
distributed applications Us client/server architecture provides shared access to objects by multiple clients. The 
server can co-exist within a client application or operate in the context of a dedicated process. Clients can reside 
on the same machine as the server or on other machines across the network No other multi-user object database 
^ engine can match NeoShare 1 * feature set, impressive perlormancc, incredibly small resource footprint, easy to use 

yet extensible programming interface and generous pricing structure. 

Full Featured 

NeoShare consists of a set of C++ classes that further extends the features of NeoAccess™, our cross-plat form 
object database engine. Taken together, NeoAccess and NeoShare form a feat Lire- rich groupware toolkit that 
addresses a complete set of collaborative development requirements, including; object persistence, organizing, 
searching, transporting, sharing, locking, updating and concurrency control. 

The collaborative capabilities of NeoShare include; client/server connectivity, concurrency control, object locking, 
transactions, a hot-link Facility, client-side caching to reduce network traffic and object overwrite detection. These 
two professional quality development uxils form the foundation upon which data intensive distributed 
applications are built. 

Full Source Code 

NeoLogic has taken a frameworks approach with our object-oriented development tools. In much the same way that 
application frameworks arc used lo construct the Front-end of an application, NeoAccess and NeoShare are the 
frameworks you use to build your application's collaborative back-end capabilities. Tins allows you to focus on the 
value-added portion of the application - the part that you know best 

As is the case with virtually all object frameworks, the NeoShare Developers Bundle comes complete with full 
source code. So you have the security of knowing that NeoShare technology is always at your fingertips. And our 
extensible architecture allows you to evolve your toolkit into domain-specific areas. 


Easy to Uso 

Migrating your application source cotie from NeoAccess lo NeoShaTe is easy because I he programming interface o( 
both products is virtually identical. This interface is designed around the concept of minimum visible complexity 
NeoShare naturally extends NeoAccess to add object sharing between diems and server. Objects obtained from a 
server across the network by a diem are real C++ objects. You treat these objects as you would any other object. 

NeoShare includes two concrete subclasses of the NeoAccess database class; a diem and a server, Vinually all the 
complexities associated with sharing objects across a network have been hidden behind the interface to these 
database subclasses. In application code, a server database object appears very much like a local database, except a 
server database also handles requests received from client applications As clients request objects from a server, the 
server maintains a set of locks associated with those objects. When the state of an object in a server database 
changes, all clients holding locks on the object are automatically sent the object's new siaie, 

A client object also supports the same application programming interface as a local (Diabase Yet rhe implementation 
of this interface may involve sending a request lo the remote server. The server performs the requested operation 
and sends the results of this operation back 10 the client. The caller of the client database needut be aware of the 
fact that the database object on which it relies is in fact delegating operations to a server database across a network 
interface The network is transparent lo ihe application developer. 

Affordable 

The NeoShare Developers Bundle, which includes NeoAccess. sells For jusi $1290 per developer with no runtime 
licensing fees. It includes full source code, sample applications, online documental ion, and 30 days of online 
technical support Site licensing, as well as educational and volume discounts 
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Presenting the extra-strength text editor. 



If you thought previous versions of QUED/M 
were powerful, wait until you program with 
QUED/M 2.7, loaded with these new pain- 
relieving features: 

Integrated support for TH INK Project 
Manager"* 6.0 & 7.0 

THINK™ debugger support 
& Code Warrior" support (now it's 
easier than ever to program for the 
Power Macintosh 3 * 5 !) 

MPW lbolServer T “ support 
PopUpFunes^ support 
Frontier™ Do Script support 

For quick relief, call 
800-309-0355 today. 


Of course, QUED/M 2.7 still has all the features 
that make it easier to use than any other text editor: 

Macro Language lets you automate 
tedious tasks 

Search and Replace through multiple 
unopened files and using GREF 
metacharacters 

File comparisons usin g GNU Di ff 
£* Unlimited undos and redos 

10 Cl ipboa nls that can be ed ited, sa ved, 
and printed 

©> Customizable menu keys 
Text folding 

m> Disp lay text as ASCI I cod cs 
Plus many more features! 


Get even more relief: Try QUED/M 2.7 now for just $69! You'll get a 
30-day money back guarantee too! Call now to order. 800-309-0355. 


NSUS 


QUED/M « jp rmJnraWt p/'rtJrmjoJt tjutofL% Inc. AH utltrr priiurts 
mtt tawbiwl?: ap rrjisfcfisif rfHiisw'in if ihti> wi^tnr WWffji 


107 5. Cairo* Avc. * Sokm Beach, CA 92075 • Tel (619) 481-1477 • Fax (619) 481-6154 S oft ware In C. 


examples published), and 1 have a specific assertion macro that 
will trigger a DebugStr if the assertion is wrong. If possible l try 
to wrap this macro around any OS Errs returned from the 
loollxix. In some cases the OSErrs don't need to lx* tested in the 
final application, so 1 leave these out from the production code. 

\ lere's an example: 

Ce t M 0 vieNextIntereatingTimo{ i heHovie. 

nextTiraRHed t aSaapIe+nextTitiieEdgeOK. (TimeVaJ up) t. 

0. fixedl. kstartPoint. HULL); 
artFrr ” GoiMoviesError0 : DebilgAssert (anErr rioErr); 
return anKrr; 

This would catch the problem immediately, Debug Assert 
will print die Ole name and line number in MacsBug. If we 
disable the DEBUG global flag Debug Assert the macro will 
expand die macro to a NULL statement, and a smart compiler 
will optimize that statement away. 

QTlIrtmiFS Library 

The sample code is using selected functions from a utility 
library with QuickTime functions, provided by Apple DTS. 
This collection of functions provides both the core set of 
needed QuickTime related operations, as well as examples of 
operations that you might tweak or modify in your liking. The 
DTSQTUUiities kit is available from developer CDs, eWorld, 


AppleLink or Internet: 

http Jto w w. i nf o.a pple. conVde v/de vinf o/q uicktime/qu ickti me.ht ml 

And also from Apple's ftp server: 

ftp ://ftp in fo.app lexom/tfts/q uickt jure/ 

I hope these examples will inspire you to write more 
QuickTime based applications and multimedia titles using the 
techniques shown. 

References 

QT4 - QuickTime 16 Features Tech Note 

QD13 - Prindpia Off-Screen Graphics Environments Tech Note 

QD21 - Of Time and Space and _CopyBits Tech Note 

thanks to Michael Manukovich of Apple, Drew Colace of 
Apple , and Guillermo Ortiz of Apple f for reviews and comments . 


To receive infor mat ion on any products 
advertised in this issue, 
send your request via Internet: 
productinfo@xplain.com 
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Source Surfer. 

Introducing the incoming wave in Mac development tools: BBEdit 3.5. This radical text editor provides an 
amazing variety of ways to browse, search, and surf through your projects. 


Let's Go Surfing, 

BBEdit's integrated disk browser provides you with 
a quick and easy means of navigating any mounted 
volume. It's the ideal tool for exploring developer and 
E.T.O. CDs. BBEdit also has the unique ability to open 
multiple THINK or CodeWarrior project documents, 
either for browsing or searching. 

Can't Find It? Just Ask. 

At the heart of BBEdit's surfing ability is a powerful 
engine for searching text, either literally or with 
UNIX™“Style "grep" patterns. This search engine is 
coupled to multi-file directory scanning, and the 
ability to search currently open windows, previously 
searched files, or project documents (even if your 
development environment isn't running)* The new 
"Quick Search" capability gives interactive searching 
as you type. So even if you don't know what you're 
looking for, BBEdit can find it. 

Project Your Feelings. 

All of this great capability would be wasted if you 
couldn't use BBEdit to write code. That's why we've 
incorporated awareness of Projector, direct support 
for ToolServer, and seamless integration as an 
external editor for use with THINK C/Symantec C++ 
(version 6.0 and later), as well as support for control 
of Metrowerks CodeWarrior (version 1.2 and later). 

We Beg To Diff. 

BBEdit's unique ability to compare folders and 
projects makes it a natural for figuring out which 
changes you made at 3 AM the night before. 


We caught the wave. 

In addition to its renowned surfing abilities, 

BBEdit supports the latest system software 
technologies: Apple Guide, AppleScript, Macintosh 
Drag and Drop, PowerTalk, PowerPC acceleration, 
and Quickdraw GX printing. There are goodies to 
make your life easier: "soft" text wrapping, 
automatic linefeed translation, parenthesis 
balancing, auto-indent, and more. You can also 
extend BBEdit with plug-in code modules. 

(We provide information and examples to help.) 

We are the wave. 

Since its first commercial release in 1993, BBEdit 
has set the pace for capability, user interface, 
functionality, and customer support that others 
are still trying to emulate. BBEdit was the first 
editor to support ToolServer, THINK Reference, 
Toolbox Assistant, THINK C/Symantec C++, and 
the leading-edge technologies mentioned above. 
We're still setting the pace for others to follow, as 
the first Mac text-editing solution to deliver on 
CD-ROM with on-board documentation, the first 
text editor to support the Internet Con fig system, 
and the first development tool with Apple Guide. 

"I Tried it Once, But Didn’t Inhale/' 

We've painted a great picture, but don't take our 
word for it. Take a deep breath, hit our FTP site 
(see below) and see for yourself. You'll find lots 
of things to like. 

BBEdit. It doesn’t suck. 



Him* Bo.nvs 

f I tv i r r t v ■ 


For more information: 

Internet: bbsw@netcom.com 
CompuServe: 73051,3255 
Applelink: BARE. BONES 
eWorld: BareBones 

ftp: / / ftp.netcom.com/pub/bb/bbsw/ 
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SYMANTEC 
TOP tO 


By Steve Howard 


SYMANTEC.! 


This monthly column, 
written by Symantec’s 
Technical Support 
Engineers, aims to provide 
you with technical 
information based on the 
use of Symantec products. 


Q: What is MacApp? 

A: MacApp is an object-oriented 
application framework from Apple 
Computer. Although MacApp has 
many similarities with the THINK 
Class Library, it is larger, more 
complex, and more modular in 
design. This flexibility has made it a 
popular tool in the Macintosh 
Programming community and has 
Ixren used for programs like Adobe 
Photoshop, and RayDream Designer. 

Q: What versions of MacApp are 
supported by the Symantec Project 
Manager? 

A: The earliest supported MacApp 
version is 3.1*1- We recommend 
version 3*1.3 (distributed on ETQ 17) 
because the examples and code will 
work without modification. MacApp 
3 3al t also on ETO 17, is a prerelease 
of the next major version and is 
basically the same as MacApp 3=1.3 
except it adds support for AOCE, 
scfiptabtfity, and the Drag Manager. 

Q: Where can I get MacApp? 

A: Symantec lias licensed MacApp from 
Apple and has included it on SDA #3- 
All non SDA customers must get 


MacApp from Apple Computer by purchasing it through 
APDA, as pan of MFWPro or an ETO subscription. To order 
MacApp call APDA at 1-800-282-2732. 

Q: What are the system requirements to install and run 
MacApp? 

A: The Symantec C/C++ for MPW folder with the associated 
electronic documentation will require approximately 22MB 
of hard disk space. The latest MPW C3-3-X) will require 
3,6M B and the prebuilt MacApp 3.1-3 system on the ETQ 
CD-ROM takes up another 20MB. You're looking at about 
56MB of disk space that you'll need free. 

Both MacApp versions come with a project model For 
Symantec C++ for Power Macintosh which, by using the 
Symantec Project Manager frees developers from having to 
utilize the MPW shell. The Symantec C++ for Power 
Macintosh full installation folder requires 44.8MB of disk 
space which, added to the requirements of the prebuill 
MacApp 3-1-3 system makes the free disk space needed 
63MB. This requirement can be reduced by using the 
alternate installation of the Symantec C++ for Power Mac 8.0, 
Apple recommends that you use a Macintosh system 
with at least 24MB of RAM for developing MacApp 
applications. Symantec recommends that the minimum 
partition for the Symantec Project Manager be 8000K with 
the preferred size being 12O0OK. You may want to increase 
the preferred sizes of the partitions depending on the size of 
the application you are developing. 

Q: Are there any installation subtleties I need to be aware of? 

A: To run MacApp 3 3a 1 under the Symantec Project Manager 
there are a few changes you will need to make. You will 
have to install Drag.h and the AOCE headers and AOCE 
library. The process to install these are outlined in the 
Release notes provided on fx>lh SDA *3 and FTO *17. 

There are also two errors in MacApp 33a 1 that you 
will need to correct to compile with the Symantec Project 
Manager, in the file UDebugViewxp you will need to move 
the #if qDebug that is before the TDebugF lags View class 
definition (around line number 92) to the top of the file, so 
it is before the first Include. Also in the file UGridView.cp, 
following the DoFulfillPromisc member function (around 
line 2460), you will need to change #endif qDrag to 
#endif //qDrag. Both these files can be found in the 
libraries folder within die MacApp3.3al - HD Ready folder. 
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neoAccess 


Cross-Platform Object 
Database Engine 


S 

h- 


Full Featured 

Now you can embed the power of a full-feaLured object-oriented database engine into your Macintosh, Windows, 
Unix and DOS based applications. No other object database engine can match NeoAccess's impressive feature set, 
including: Blobs, part lists, iterators, swizzlers, temporary objects, multiple indices on a class, inverted indices, 
stored queries, schema evolution, a powerful relational query mechanism, a streams-based i/o model and incredible 
performance. 

High Performance 

Internally, NeoAccess uses extended binary trees and binary search 
algorithms to achieve optimally short access Limes. Its automatic 
query optimizer ensures that queries always use the fasLesi access 
path to objects. And indices are dynamically combined, collapsed 
and compressed to keep access times to an absolute minimum as 
the contents of a database changes. NeoAccess's object caching 
boosts perlormance by keeping objects in memory even after Ixring 
disposed of by the application Your application's memory size is 
reduced because only those objects of immediate interest need io be 
in memory at any one time, not the entire file. 

Full Source Code 

We've taken a frameworks approach toward object persistence and database technology. In much the same way that 
application frameworks are used to construct [he front-end of an application, NeoAccess is the framework you use 
to build your application’s back-end. As is the case with virtually all objecL frameworks, the NeoAccess Developer's 
Toolkit comes complete with full source code, for all major application frameworks including Mettowerks’ 

Power Plant, Symantec's THINK Class Library and Apple's MacApp on Lhe Macintosh and Microsoft's 
Poundatiou Classes, Inmark's zApp and Borland’s ObjectWindows in Intel-based environments. It can even be 
used without a framework or in one that you've designed. 

Easy to U*e 

The programming interface is designed around the concept of minimum visible complexity. Application-specific 
objects inherit persistence properties from a NeoAccess base class. These objects are organized in the database 
primarily by class, But NeoAccess also knows how classes are related. So multiple classes can be searched in a single 
operation. And of course objects of any particular class can be organized using multiple indices. NeoAccess is 
unique in that it allows objects to be located based on abstract selection criteria or based on their relationship to 
other objects. There's literally no database administaiion to deal with - NeoAccess takes care of all the details. 
NeoAccess also includes a Blob mechanism which allows free-form variable-length data to be stored in databases 
with die same ease as fixed-length objects. NeoAccess even includes a powerful set of keyed iterators for traversing 
indices and part lists. Keyed iterators have the umque ability io iterate over only those objects in a set that match a 
given selection criteria. Your users will appreciate NeoAccess because databases are completely self-contained in a 
single document file. So users can treat a database file as they would any other document. 

Proven 



NeoAccess has been commercially available since 1992. Thousands of commercial and in-house applications based 
on NeoAccess technology have already been deployed. NeoAccess can help your organization deliver powerful 
products in a more timely fashion than you ever imagined possible. 

Affordable 

NeoAccess's best feaLure is its price. The NeoAccess Developer's Toolkit sells for just $749 per developer with 
absolutely no runtime licensing fees It includes /till source code, numerous sample applications, 500 pages of 
documentation, and 30 tlays of technical support. So what are you waiting for? 
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You’ve spent 

enough 

time in 
development, 

Don’t let your 
installer keep 
you from going 

golden. 


UpiUnatlon 


[✓fj Specified Folder 
<Q> Ilsur Specified Disk 
Q Startup Oivk 
□ Desktop 

LtJ fletiue Hupli? Menu Items | 
133 flcliue Central Panels 
LQ1 Refine Eiflermon* 

CD Relive Fonts 
1^] Relive Preferences 
3TJ Relive Sloittip Items 
LfiJ Hctiue Syslem Folder 



Persians 
EHisling File 
System 
Display 



flay Processor 
Rny 680ft f) 

Rny PowerPC 


or higher6B0 hQ 



Just because your 
software is done doesn’t 
mean your work is. You 
still have to write an 
installer. And that can 
add precious days or 
even weeks. 

With Aladdin 
Systems’ proven 
installation standard, 
Stufflt InstallerMaker,'" 
you can have your 
PowerMac® or 680x0 
product ready to ship 
literally within minutes, 
and save money to boot. 

Stufflt InstallerMaker 
usas our advanced 
compression technology 
to reduce the number 
of disks needed to ship, 
which saves you money 
on every unit. Its menu- 
driven interface is so 
easy-to-use that even 
your VP of Sales could 
prepare your installer. 

New version 2.0.2 
adds full PowerMac 
support, improved 

scriptability, 
and 

expanded 
localization, 
including German, 
French, and Japanese. 

Tb receive a free, 
fully-working copy of 
Stufflt InstallerMaker, 
call our licensing 
department today at 
(408) 761-6200. 



« IHrf Aladdin Syturti* Int 1 E WrtLndfi* Dnm, 
CA KOTS Pw. («0A> 7« t-tttt Aitwrica 
riifa^AppteLink AUDVtN Imrmrt 


AJwkfip Systems. Ire. AU iMhcr produili bit 
tndwum or thrir rapeon* howfcrt 


Be sure to read the Release notes and readmes provided 
with either SDA #3 or ETG #17, They provide information 
that is essential to you being able to successfully develop 
with MacApp and the Symantec Project Manager 

Q: What is SMiG/Cpp ? 

A: It is the PowerPC compiler for MPW. It is compatible with 
MrC/Cpp. You can build MacApp with SMrCpp, instead of 
using MrCpp. As of ETO #17, you may have to rename the 
SMrCpp to MrCpp to trick MABuild to use SMrCpp for build. 
Then you would just use MABuild -cp MrC ,,,, 

Q: 1 want to weak link a shared library (e.g. 
QuickDrawGXLib.xcoff) to a project because I want my 
application to run even if the shared library is not present. 
How do I do this? 

A: Bring your project up to date and double click on the shared 
library in your project window, (if you did not update the 
project before you double click on the shared library you 
will get an error “Gould not complete the last command 
because the AppleEvent was not handled. Error = -1708”). 
Turn on the “Soft Import Binding” radio button. In this case 
your program should take care not to call any non-existent 
romine in the shared library, 

Q: 1 am precompiling my header files and am getting the 
following build error: 

File “TextUtils-h"; Line 311; While compiling “Mac 
*includes.c p Error: 'stringtonum* previously declared as 
something else 

It was declared as: void C funcCchar const long *) 

It is now declared as: void C funefehar \ long *) 

A: Go into the header file BDC.h in the 2.0a4 Universal 
Headers folder that you copied from the Symantec C++ for 
Power Macintosh CD-ROM and change the following code: 

#ifdef CGLUESUFFQRTED // defined in 2,<fo4 or Lucr 

void Etringtomui](const char 4 theString. long *theNuni); 

#else 

void atringtonum(const char *rheString. long ‘theNum )■ 
#endif 

to: 

#i fdef CGLUESUFFORTED // defined in 2,G»4 or later 

void stringtormmt const char *the$tring. long *theNanJ: 

#else 

void stringtonumtchai: *theString* long *theNij« ); 
ihndif 

This is only a problem with the newer version of BDC.h that 
comes with universal headers 2.Ga4 

Q: Why are the structs in my PowerPC project a different size 
from those in my 68K project? 
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Tools Plus 2.6 

Tools Plus gives you the routines you need to create 
a professional looking user interface. 

Then we make it work. Ifs that simple. 


* 




/ Codi* Warrior f C/C++ ^ PowerPC 

Symantec ✓Pascal ^600x0 

• Over 170 high-powered “set arid forgeT routines that automate and enhance: 
ev^nt handling, windows, the tool bar, floating palettes, curaxs, Miens, 
picture IxiHons, sc ml I tws, menus (pull-down, hierarchical and pop-up}, 

list boxes, fields. Edit mem, clipboard. Dynamic Alerts, and men?,,. 

• Easy u? I cam and easy to use •For novice, intermediate and 

advanced programmers 
Runs fasti needs little memory or disk space 
Safer than toolbox routines , - 

No royalties E nK I 


* Suhsianttal code reduction 

* Dramatic code simplification 

* Significantly less debugging 

* System G and 7 compatible 


language 
OC/C++ 
O Pascal 

® Bum 


0 Saues Time 
13 Saues Muireij 
H Easy to Use 


9 

10 

H 

18 
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A: By default, the PowerPC compilers align fields within strucLs 
to 4-byte boundaries, ITie 68K C++ compiler, by default, 
will align the fields within sLructs to 2-byte boundaries. 
THINK C will always align fields within structs to 2-byte 
boundaries, 68000 chips must reference word or long 
values from even addresses. Therefore, the 68000 chip 
requires, at least, 2-byte alignment. More recent 680x0 chips 
do not have this limitation, but perform faster when 
referencing word or long values from even addresses. The 
68040 and PowerPC chips perform even faster with 
structures aligned to 4-byte boundaries. 

If you need to share data structures in memory between 
68K and PowerPC code, or need to read or write a data 
structure from/to disk with both 68K and PowerPC code, 
you will need to enable the same type of alignment in both 
your 68K and PowerPC projects. 

Q: I’ve heard that Symantec is going to make the THINK 
Reference compiler available to developers so li icy can create 
their ow n databases. When is that going to be available? 

A: The THINK Reference compiler is not ready to be released 
to the developer population as of yet. If you are interested 
in becoming a IxTa tester for the 11IINK Reference compiler 
you can contact us here at technical support hy email at: 
support@devtools.symamec.com or by calling: (503)465- 
8470 and we will lie able to start die necessary processes to 
get you in our beta testing program. 




Can you spot 
the difference? 


Plenty of people ain't. Because whether you update software with a full 
set of program disks, or a Tile made with t lpdateMaker 2, the result is 
die same GuaianteedUpdateMaker updates are totally reliable 
Us system of 32-hit checksums ensures that it updates the right file. 


And UpdateMaker is easy-tO-HSe - simply SjTecify the files and 
UpdalcMakcr builds the update. There is no scripting or use of 
Resl-dii It’s even easier for end-users - just one button to press. 


UpdaieMaker 2 works with any type of Madntosh file Tire updater 
files are extremely COiHp(iCl Ami die program options numerous. 
You cm preserve or override user eustoniisations. Save files in Binhex 
format. Update up to 20 old versions with one file. 


The real difference is Lhe savings in time and money. Which explains 
why some of die besl-known names in software development have 
already discovered Update Maker 2. 

Distribution is unrestricted and royalty-free* 

Only $225, order now (415) 964 2878 

<ir ApplrH nk:M at E abtHT 



UpdateMaker 2 


AOInstrumcnls, 2225 Gram Road, Suite Los Alios. GV 94U2+ Fax: (415) 964 2SS6 


Special thanks to Michael Hopkins, Yuen Li, and Kevin Quah. 



September 1995 • MacTrchMagazine 


Symantec Top 10 


3 


















































FREE INSTALLER! 

To: Mac Developers & Product Managers 

From: MindVision (Creators of Stacker for Macintosh) 

Subject: Free Copy of DEVELOPER VISE 3.0 

Message: We've got a great new installer for you. 
Here's your chance to try it for free. 

No risk, no obligation, no hassle. 

Call today, don't delay! 
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Cal (402) 477-3269 


IF YOU PREFER, USE E-MAIL. APPLELINK, AQL: MINDVISION » COMPUSERVE 70253,1437 



Join ihc grow ing list of companies who use our VISE technology: Adofje, Apple, CE Software, Claris, 
CompuServe, DdtaPoint, MacioMedia, Radius, Stac Electronics. Symantec, WordPerfect, and many more- 


MindVision Software 840 South 30th St., Suite C, Lincoln, Nebraska 68510 
Voice; (402) 477-3269 Fax; (402) 477-1395 AppleLink, AOL: MindVision 

t 1992-94 Mrnd Vision Software. Alt Kellis Reserved. DevdoperVISP. is a trademark of MindVision Software, 
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By John O'FaUon,john@maxum.com ^3 


Writing CGI Applications in C 


Inject Some Adrenaline 
into your World Wide Web 
Server Applications. 


For the last two months this column 
has been teaching you how to write CGI 
applications for Web STAR using 
AppleScript, AppleScript is a wonderful 
environment for tying existing Apple 
event-a ware applications (database 
engines, for example) to Web STAR, It 
also provides an easy way to get your 
feet wet with CGI applications. 
Inevitably, though, there will come a 
time when you need a high-throughput, 
high-reliability CGI for your WebSTAR 
server. For that, we turn our attention 
to the C language. 

Writing CGIs in C will be very 
comfortable for most experienced 
Macintosh programmers, and will provide 
all of the performance and reliability the 
most demanding servers need, fn 
addition, w hen writing CGIs, you can get 
these benefits without the headaches that 
are often associated with C. For 
example, developing in C normally 
means spending a lot of time on the user 
interface. But CGI applications don't 
typically need any significant interface, so 
all you need to worry about is the actual 
job that you are trying to accomplish, 

if you aren't already somewhat 


familiar with programming in C you should stop right here and 
sj>end some quality time with a C programming primer. You 
don't necessarily need to be a C ace to write a good CGI, but 
familiarity with the language, the basic libraries and the 
Macintosh TooLBox are essential I will also assume that you 
already have some experience with WebSTAR and with the 
topic of CGI applications in general (if not, see the July and 
August issues for “CGI Applications in AppleScript") as well as a 
basic knowledge of HTML. Now, on to the topic at hand. 

Apple Events 

CGIs exist for Apple events. You will he building an 
application whose sole purpose in life is to receive Apple 
events, look at what they're asking for, do some processing, and 
send back some reasonable responses. So, to begin, well start 
with an overview of just how Apple events are used to send 
and receive information. Please note that 1 haven't read the 
Inside Macintosh chapter on Apple events in almost a year, so 
for the real deal, in all its glorious detail, look at Inside Mac, 
Volume VI, Chapter (x [or Inside Macintosh; huerappikatum 
Communication, Chapter 3 - Assoc. Ed, jaw} 

Set it Up 

All a CGI really needs to do Ls respond to Apple events that 
are originated by WebSTAR. Luckily for us, responding to Apple 
events turns out to be quite a bit easier than sending them. 

Responding to Apple events starts by installing a series of 
event handlers. An event handler is a procedure that will lie 
called to process a given event, based on the event class and 
event ID, Every event is defined by ils class (an attribute 
representing a group of events) and its ID (within the group, 
the specific event that needs to occur). 

Your CGI will install five (or possibly more) Apple event 
handlers. The first four evenLs to lx? handled are the “core” 
events thaL all gcxxi Apple event aware applications support. 
These events are: open the application, open a document, print 


John <Xballon - John OTalion is lilt lead developer for Maxum Development Corp., a Web software and services company 
based near Chicago, IL ( tl htrp://www.^naxl]mA L om/maxum/ , '). Maxum developed and markets the first commercially available 
WebSTAR add-on tools: NetCloak and Net Forms, 
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a document, and quit the application. The fifth event is the 
interesting one,,. 

WebSTAR defines a single event class (WWWQ) and event ID 
(sdoc) which is used to pass requests from WebSTAK to your 
application, Your CGI will install a handler to process events 
with these attributes. These attributes, and the procedure to lx: 
called when an event with that class and ID are received is just 
about all you need to know to install your event handler. 

There is one other missing piece. In order for your CGI to 
run in native mode on PowerMacs, you'll need to reference 
your Apple event handling procedure as a Universal Procedure 
Pointer, This is easy enough, and is illustrated in the procedure 
below, which installs event handlers for ail five of our events. 


void TnsiallAllEvtiits [) 
l 

GSErr MyErr; 

AEEventHandlerUPP MyUPP; 


iiftliilLYllEvtim 


MyLTPP - NewAEEventHandlerPrnc (HandOpenApp) ; 

MyErr = AETnatal lEventHaridler 

(kCoroEveniClctas *kAEOp supplication, MyUPP, 0, FALSE); 

MyUPF - HBwAEEventHatidlerProc (HandOpenDoc) ; 

MyErr = AEInstnllEventHandler 

(kCoreEventClass f kAEOpenDocuinent£j ,MyUPP , n, FALSE); 

MyUPP = NewAEEventHandlerPror (HandPrjntDoc): 

MyErr = AEInstallEventHandler 

(kCoreEventClass.kAEPrintDocumen in ,MyUPP,0,FALSE): 

MyUPF - NevrAEEventHandle rProc (llandQuitAppl ; 

MyErr = AEIn a t a1 lEventHaa dle r 

(kCoreEventClass > kAEQuitApplicatien P MyUPP,0 r FALSE): 

MyUPP - NevAEEventHandlerProc (HandCl 1 ent.Request) ; 

MyErr = AEinctallEvantHandler (WWWO' \ 'sduc: 1 ,MyUPP,0 ( FALSE); 
if (MyErr != noErr) ( 

SysEeep (2)i 

// Wefl behaved apps would do more dian beep] 

1 

1 


The parameter passed to WewAEEventHandlerProc is 
simply the name of the C procedure Lhai will be called when 
an Apple event is received for the defined class and ID. 

Watch For It 

Now that the Apple Event Manager knows about your 
event handler, and knows the Apple event class and ID it can 
handle, you need to start watching for events. This is done m 
your main event loop, by adding support for high-level events. 

In addition to mouse clicks, key presses, etc., your CGI 
application will receive high level events from the system, via 
WaitNextEvent. When an Apple event is sent to your application, 
Wait Next Event will respond with the kHighLevelEvtmt constant 
in tlx what 1 field of the EventRecord, When a high level event is 
received in your main event kx>p, it is up to your application to 
dispatch it to the Apple Event Manager, which will in turn call your 
event handler The code is simple, and looks like this: 

while (QuitApp—FALSE) I 

// Go through the event loop is hwig as we aren’t supposed to quit 
WaitNextRvent (everyEvent, ^Action. QL. OL); 

// Ask the OS for an event 
switch (Act Ion.whol} [ 

case mouseDown; //They clicked the mouse... 

HandleHouseBown (Action.where); 
break: 


case key Down: //They pressed a key.. 

1 Liiid 1oKeyUown (tint)Action.message.(int)Action.modifiats); 
break: 

case kHighLevelEvent: 

// Wc have an Apple event... so let the OS... 

// dispatch it (see Inside Mac). 

MyErr = AKProcesnAppUEvent ({(Action): 
if (MyErr 1= noErr) I 
Sysheep (2); 

// Well behaved apps do more than beep! 

J 

break; 

\ 

l 


Handle it 

The Apple Event Manager will take the event and took for 
an installed handler dial accepts events of the given class and ID. 
When it finds an appropriate handler, it will execute it. In the 
example above, the procedure name was HandClieritReqiiest, 
so this is the procedure lhat will be executed, 

WebSTAR is very generous about the information that it 
supplies to your CGI, so your first task when you receive an 
event is to pull out the variables that are passed to you. There 
are quite a few variables, and StarNine adds new ones fairly 
regularly, so there is no way to cover them all here. Cheek your 
WebSTAR technical documentation fora complete description of 
the parameters. The documentation will tell you what 
information die parameter holds, and whai its name is. The 
name, like the Apple event class and ID, is a 4 byte constant. 

To pull a parameter out of an Apple event, you use the 
AEGetFaramPtr routine. You specify the name of the parameter, 
and AEGetParainPtr will copy the data into a buffer and tell you 
how long It is. I normally use die length variable to cap the 
buffer and make it Into a C string. Here are a few examples: 

// * 1 - direct parameter 

MyErr^AEGetParanFtr (TheRequest , 1 --- - 
* h typeChar >&ReqType* (Ptr)Po.stArg_Direet ,1023, 
fcReqSize): 

PostArg_DireetCReqStze] = '\0 ( ; 

// addr' - diem address 
MyEr r=AEGet Param? t r 

(TheRequest. 'addr' . LypeChar. HeqType, (Ptr)PosiArg^Address *255* 
&RcqSi 2 ie) ; 

FostArg_Address[KeqSizeJ = 1 \0 f ; 

// Agm' user agent 
MyEr r=AEGe t P a r aaPt r 

(TheReques t, 1 Ag nt 1 , typeChar. SReqTy pe. (Pt *) Post A i g_Cl ien -.,255, 
AReqSize); 

PostArg_Cllent[Req5i/,e] = ’\G f ; 

// 'post 1 - post arguments 
MyEr r=AEGet Fa ramp tr 

(TheRequest,'post T .typeChar,&ReqType.(Ptr)PostArg_Post, 

S191,SReqSize): 

FostArg Post [ReqSize] ” 1 V0 f ; 


Let's take a closer look at each of these requests, 

• The first parameter, TheRequest, is a pointer to the Apple 
event sent from WebSTAR. This tells the Apple Event 
Manager what event we’re processing (and so, where to 
pull the parameter from). 

• The second parameter is the four byte name of the 
parameter, as defined by WebSTAR. 

• The third parameter is the parameter data type. The Apple 
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Software Development '95 is the 
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Event Manager supports an extensive list of data types, with 
a complete set of coercion routines. WebSTAR, however, is 
nice and consistent, always sending parameters as good old 
typeChar, 

• The fourth parameter, ReqType, allows die Apple Event 
Manager to tell the CGI what data type the parameter is, but 
I ignore this field, since f know that the Apple event is 
coming from WebSTAR and that ifs always a typeChar 

• The fifth parameter is a buffer to receive the data, followed 
by the maximum length of data to be copied into the buffer. 
Make sure that your buffer is big enough to hold as much 
data as you say you can hold. Also, well he adding a null 
to the end of the string, so make sure you have a byte to 
spare for that. 

• file last parameter is a 'Size' variable Lu receive the length 
that was actually copied into our buffer. 

Choosing sizes for your buffers is somewhat arbitrary, and 
is done on a Held by held basis. POST arguments, for example, 
can lie up to 24k in length. Often, it makes sense to accept this 
much data, but in many cases, where you know the HTML 
form will lx; asking only for a few short fields, you can get 
away with substantially less. Also, in this example, we accept 
up to 255 characters for both the client address and for the user 
agent (the name of the browser). Both of these are probably 
more than long enough; I could most likely get away with 64 
bytes for each, or less. 

Finish It 

Let's take a second lo recap... We detected our Apple 
event and dispatched it to the Apple Event Manager. The 
Apple Event Manager passed it off to our handling procedure, 
which read in the parameters it needed from WebSTAR. Next, 
the CGI went off and did its thing, and now it finally is time to 
respond to WebSTAR. 

Well talk about processing the request and how to build 
the response 1 string in a few minutes, but first, let's finish with 
the Apple events. The last bit of Apple event processing we 
need to do is send the response. This is done quite easily with 
the AEPutFaramFLr routine. 

The nice thing about responding to Apple events is that 
the Apple Event Manager knows you are going Lo respond, so 
it builds the response event for you, before your handler even 
gets called. Once your handler finishes, it sends the event back 
to WebSTAR too. All this leaves for you lo do is to copy your 
results into the event before you finish. Here is how that looks: 

MyE* r~AEPutParamPtr (TheReply,keyDirectObject,typeChar, 

(Ptr)PostArRjtesponse< ReqSize); 

TheReply is the Apple event that was created for us by the 
Apple Event Manager for sending our response, 
keyPI rectObject is a constant which represents what can be 
thought of as the main parameter of the Apple event (which is 
the response text, of course), typeChar simply tells the Apple 
Event Manager that the data is a string. PostArg_Respon se is 


a pointer to our response text, and ReqStze is the length, in 
bytes, of our response. 

Whew! WeVe done all the work we need to do in order 
to communicate with WebSTAR. It's quite a process, but the 
Apple event code also happens to be pretty static; the code 
presented here can be used almost verbatim in just about any 
CGI you would care to create, so now that weVe done die 
work of communicating with WebSTAR, we can move on to 
actually doing our job. 

Parsing the Post 

Many CGIs function based on user-input, which comes from an 
HTML form. Forms are easy to build, and the browser handles 
all the editing controls for you, so your CGI won’t know the 
user is filling out a form until they are done and press a 
“submit" button. The upside to tills is that all you have to do is 
process the data, forgetting almost entirely about the user 
interface. The downside is that there is a lack of control during 
the editing process. 

In any event (well, actually in an sdoc event), when die 
user submits the form, it'll come to you as an ASCII string. The 
string will list the field names as they appeared on the HTML 
form with the associated user-entered data. The field names 
are separated from the field data by an equal sign (=) and then 
ampersands (&) are used to separate the various field=data 
pairs. At the same time, any special characters in the field data 
(such as & and =0 are encoded with a percent sign (%) and the 
character's ASCII code in hex. 

Maybe an example will be clearer, for a simple form that 
asked the user for their name, job tide, and e-mail address, you 
might get die following post data: 

UserNaine~John& JobTit le=Sof t va rs%2GDeve lops rSEMa 11 =j ohntaxum. 
com&unnamed * aubni t - lnpi|t:“Subin i t XZQFnrm 

Notice the instances of %20. These are encoded spaces (a 
space has an ASCII value of 0x20). Other characters like 
colons, slashes, etc. would give us similar encoded values. 
When your CGI receives this text string, the first thing it will 
need to do is decode those ASCII values. This is a fairly easy 
task and looks like this: 


Replace Special Chars 

r .....■./ 

/* RliPLACESPEOALCHARS replaces instances of percent signs (%) V 

r followed by an ASCIt char value with the actual character. V 

.... 

void ReplaceSpecialChars tchar *TheText) 

I 

int i; 
int 

int Asciidiar: 

i - 0; 
j - 0; 

while (TheText [i] I- 1 \0 f ) [ //Search the entire text block 

switch (TheText[1]) ( 

case ■ % 1 : // if the char is a percent sign, Iwk at the next char 

if ((TheTextti+lJ >= 'A') &S (TheText U+Ij <= 1 F 1 )) l 
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AfieiiChar = TheTextfin] - + iq- 

// convert A thru F to 10 thin 15 

I 

else 1 

AecliCha r = TheText [i+1 J - 'O';// Convert all mhra to 0 to y 

I 

AsciiChar “ AsciiChar * 16: 

// H’hiit was the high order of a hoc number, so mull by 16 to 
// find fhc decimal value, Now tSo the tow order char.. 
if {(TheTextfi+2] >= 'A') 66 (TheTextli+2] <« P F*)) [ 
AsciiChar N (ThnText[i+2j - 'A r + 10): 

// Convert A thru F to 10 thru 16 (and add it to the high onlrr value) 

else ( 

AscllCtoat += (The! ext [t+2] - p 0 f ); 

// Convert all others to 0 to 9 (and add it to fhc high order value) 

if ((AsciiChar >= 0) 66 (AsciiChar < 256)) t 

// if we got a valid value, replace the ASCII char 

if (Aset I Char — 10) ( 
i--; 

J 

elite f 

The Text l j 1 “Ascii Cha r; // Copy the d tar inti > the string 

i 4- 2; 

// Now that we have convened 'em, skip the extra characters 

else I 

TheText t j j “ TheText {i]: 

// fa be alarm* nothing to convert, just copy the char (shouldn't happen) 

break; 
case *+': 

TheTex i {j J - 1 1 ; // Spaces are coded as plus signs 
break; 
case 

TheTexttjI - DEUMJEHAR; 

// Replace the default delimiter with something more uncommon 

break; 
case 10: 

j : // Strip out linefeeds* Macs don't use them 

break: 

default: 

TheText I j) “ ThoTem t± j ; //A normal character, just copy il 
break; 


1 ++; 

j H < 

I 

Tli pTox l [ j 3 * MOM // make su nr the string is capped 


.....(ictFieklData 

r GETFIELDDATA searches PostArgJ’ost for the specified field */ 
f* name and returns the text entered by the user */ 

.***“«—«**»™./ 

int GetFieldData (char ■ PastString, char *FieldN 3 iuc* int 
MaxLength* char “TextBuff) 

I 

int i* StrLen,Found,Position; 


St rlon - 0 ; // First, End out how long the field name is 

while (FieldNane[StrLen1 !- MOM StrLen++; 

Found = FALSE \ // Assume wc haven't found anything 

Position “ 0: 


wniie ujootiu = FALKS) 66 ^FoetStringlPosilLioriJ ]= M0')) I 
// kHik til we find something or we lilt the end 
Found - TRUE; // We can hope, can't we? 

for (1 = 0 : i < SirLen ; 14+) // if any character at all doesn't match 

if (FostString|PoEition+i ] f= FieidNatne [ ij) | 

Found = FALSE; ff then no deal, and stop trying 

i - StrLen: 
i 

Position++: 

J 

if (Found) t //OK.. Great... We found our fiekl 

Position += (i - 1): // Start lookinrg for the Udi milting V 

while (Post String[Position] J- Poaition++; 

Pos i t i on++: // Skip over the ‘=i + 

i ^ 0: ff Almost done, just copy the string 

while ((Post St ring [Position H] ! = 1 \Q*J 66 

(PostS t ring [Fosition+i] I 3 DK1JM_CHAR) 66 (i < MaxLength)) f 
TextBuff[iJ - PostString[Position+ij; 

// Copy die user entered text into the buffer 


i++; 

I 

TextBuff [i] = MOM //<iip theCstring 

return (TRUE); 


else t 

TextBuf t" [Oj “ M0': //Roum a NULL string 

return (FALSE); 

I 

1 


There are other ways of extracting this information from 
the POST string, but this is a handy routine that is easy to gel 
started will). 


While the routine decodes die ASCII values, it also replaces 
the ampersands that delimit the fields. 1 did this lx.-cau.se an 
ampersand is actually a fairly common character for people to 
use. and will confuse things mightily if it appears in the text and 
is used as our delimiter. So l)ELIM_CHAR is simply defined as 
something more obscure. The omega (£1) works well - il is rare 
hut can lx- typed easily and is quickly recognizable. 

You will also notice that the routine converts both plus 
signs (+> and the %20 ASCII encodings into spaces. This is 
because some browsers (notably NetScape and Mosaic) encode 
spaces as plus signs, and we’d like to stay compatible with as 
many browsers as possible (not to mention die fact that most 
people use these two browsers). 

For the last step, we need a way of extracting the text for 
any given field. All we need to do is scan through the text 
kxrking for the field name followed by an equal sign. When 
we find that, we simply copy the user entered data into a 
buffer. Here is a simple routine to do just that: 


Thf. Equivalent of “Hiuxi World!” 

So, let's write a CGI that will be the equivalent of the ever- 
popular “Hello World!”. We ll create a simple HTML form with 
two input fields and a “submit” button. When the user clicks 
“submit", our CGI will take the words in the two input fields, 
stick them together, and respond with some HTML text that 
shows the user what we did. We stan with the HTML form... 

^ ] ixfil) 

<TITLE>Hello World I Test</T1TLE> 

<B0DY> 

<F0RM METHOD-POST ACTION-"/HelloWorld.rgi"> 

Enrer a word in each of the fleldfi below... 

<P><B>Field 1:</B> <INPI)T TYPE’'text’ NAME-“Field 1 * ST7.E—32" 
MAXLENCTH—3 2"> 

<P><B>Fl«ld 2: </B> <INPUT TYPE-”text" NANB—Fiel<12* SIZE—32* 
HAXLENGTH— 12* > 

<P><INPUT TYPE-submit VALUE— Submit Fotm"> 

</P0RB> 

</B0DY> 

</HTML> 
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Last month, Jon Wtederspan wem into some derail about 
how forms work, and they are very well documented in many 
places on the Web, so I won't go into detail about what is 
going on here. There are, however, iwo important things to 
notice. First, the action parameter of the FORM command is 
“ /Ho 11 oWo r 1 d . c.g 1 " ■ This is simply the file na me of the CGI 
application we are going to write. The application name must 
end with either \egf or ".acgP to be recognized as a CGI 
application by WebSTAR, (Actually; you can reconfigure the 
file extension definitions within WebSTAR to recognize oilier 
extensions, but we won t get into that here.) 

The other thing to notice is the field definitions. They are 
both text fields and are named Field! and Field?, (creative, 
eh?). The field names defined in the HTML file will be 
important when we go to parse the POST argument in the CGL 
Now for the CGI axle. All of die code listed so far wall lx- 1 
needed, as well as other standard Macintosh application stuff lor 
initializing menus, windows, etc. I lie core of die program will 
be the HandIcClicntRequest routine, and will look like diis: 

H until lienlRequest 

pascal OSErr HandCliantRequesi (AppleEvent *Thefcequest* 

AppleEvent *ThaR«ply, long. Reference) 

I 

OSErr MyErr: 


DescType ReqType; 

Size ReqSizc; 
char Post[1024]; 
char Response[1024]: 
char Fieldl[64j ; 
char FleH2r641: 

// Get the post dau 

MyErr^AECelPiiramPtr (ThaRequest. 1 post 1 , typeClmr*&Rei]Type* 

(Ft t) Post, BUFFER_STZFa.&ReqSlze) t 
Post Arg_Post [ReqSize 3 * ' VO T : // and cap it as a C firing 

RepLireSpecialchars (Post): // Replace the special character 

CelficldData (Post. *Pieldi h . 64. Ficldl); //(iet(heusercniocddata 
CetFi e Id flu t a f Pos t. w Fie 1 d2 * , 64, Field?) ; // out of the jmim string 
sprint! (Response, 

M <HTML><TlTUOCGi RESPONSE </TITLE) <B0DY><H1 >%b 
%a</Hl></BODY></MTML>*. 

Field! , Field?) ; // Build the ifJ’ML response string 

R cqS I ?.& - st rlen (Response): // Get the - of chars in the response siring 
My£r t “AEPutPHraHiPtr (TheReply jlteyMroctObjeet * 
typoChar, (Ptr) Response , ReqSize) r 

return (MyErr)r 
J 


This example is a bit over-simplified, bui works for our test. 
For one tiling, in a real CGI, you would probably warn to allocate 
mure memory to both the pcxst string and the response siring, 

Hhe firsi thing that happens in our application is a high level 
event is received from the OS. Our main event loop passes it off 
to the Apple Event Manager, which calls this routine. When 
HandClientRequRK L gets the request, it pulls the POST 
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argument out of the Apple event and then parses out the user 
entered data using Get Field Data. After that, all it has to do is 
put the user's words into a simple HTML response and stick the 
resulting string into the reply Apple event. Piece of cake, 

CGI vs* ACGI 

We wrote “HelloWorkLcgF as a CGI, I nil we might warn to make 
it an ACGI (Asynchronous CGI). ‘Hie difference here is simply in 
the filename of tile finished application. This example program 
will run as either a CGI or an ACGI just fine; the difference is in 
what WebSTAR does when it sends the event to us. 

If the application ends with Tcgi*, then WebSTAR creates 
the Apple event, sends it off lo our application, and waits for a 
result. All server activity stops cold while the CGI does its 
thing. With an ACGI, WebSTAR sends the event and goes 
merrily on its way serving other connections. This sounds tike 
a belter solution, and often is, but not always. 

For example, our" Hello World.cgT should lx: left as a CGI, It 
is so fast that it wonT really cause a delay on the server, and 
making it an ACGI would just add overhead that we have no need 
to incur* So plain old CGIs can lx: safely used when the CGI is 
doing something very' fast. ACGIs should always be used when 
processing might take a bit longer, so that other connections don’t 
gel hung up waiting for the application to finish. 


Out if the application is running asynchronously, you ask, 
what happens when WebSTAR sends us a new event while 
we're processing another? Simple. While our CGI is 
processing an event, the main event loop isn’t running, so 
Apple events aren’t being processed and will build up in a 
queue until we are ready to handle them. So even though 
WebSTAR is processing connections asynchronously, the CGI is 
processing them one ai a time. This isn’t a problem unless the 
CGI is going to spend a large amount of its time sitting idle 
(say, waiting for results from a client/server database engine 
running on another machine). In this case, processing 
incoming requests synchronously can become a big problem. 

Threading 

We really have three classes of CGIs, and we use each 
depending on the situation at hand. 

* When your CGI will be very fast, make it a CGI. “Very fast” 
means that ii probably works strictly within memory and 
doesn't have to wait for disk I/O or other slow processes, 

* When your CGI is fast, but can take a second or two to run, 
use an ACGI* ACGIs can also safely be used when 
processing will Lake a long time to run but is fairly 
uncommon. If the CGI isnT run very often, the requests wall 
rarely pile up in the Apple event queue. 
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• When your GG1 may take longer than a few .seconds, and 
when ir will l>e accessed frequently, you have little choice 
hut to make it threaded or else il will become a processing 
bottleneck for the entire server. 

Writing threaded applications simply means that the 
program uses die Thread Manager ro execute multiple instances 
of parts of your program simultaneously. Without going into 
the details of the Thread Manager, here is how a CGI can use 
threads to perform its job for multiple simultaneous connections, 

1) Receive the Apple event in the main event loop, 

2) Suspend the Apple event 

3) Spawn a thread and pass all connection information (post 
siring, etc.) to the new thread. 

4) The main event loop yields to any active thread. 

5) Ibe thread performs its task. At key intervals (usually when 
wailing for stow processes) the thread yields to other active 
threads (including the main event loop). 

6) When the thread has built its response, it resumes the Apple 
event and replies. 

7) The thread disposes itself. 

The Thread Manager implements “Lightweight" concurrent 
processing, so switching between thread contexts is extremely 
fast You will notice very little performance degradation by 


making your CGI threaded. .Also, you'll find that making the 
Thread Manager calls are relatively straightforward, but there 
are a couple of “gotehas". First, you can not allocate or release 
memory within a thread context. Your main event loop should 
do all of this and then pass the handles or pointers to each 
Lhread. You will also need to watch your use of global 
variables closely. Glofxil variables are available to threads, but 
they are common to all threads running. So using globals can 
be very handy, but make sure you don’t rely on a global 
variable for storing data within a thread or you may find the 
threads are writing over each others 1 data. 

Other Special Considerations 

Being a server-based application, your CGI will need to pay 
special attention and lie a good citizen. Here are just a few tips: 

1) Release the CPU as often a.s possible, and for a decent amount 
of time. In general, your main event loop won’t be doing 
much when your CGI is idle, so all you realty need to do is 
use a large value for the "sleep Licks” in your WaitNextEvent 
call Sleep ticks apply only to idle events, so you will be 
notified immediately when an Apple event comes in anyway. 

2) Don’t use modal dialog boxes. Many servers will be 
unattended, and modal dialogs are a sure way to hang the 
server. If you get errors, w rite an entry into a log file, or display 
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the error on your status window (if you have one) and beep. 

3) CCjIs are limited to 32K for the return file size, so if your 
application is running as a CGI, you won 1 ! Ik- able to send 
huge return strings, The limit on ACGIs is much higher, 
and is dependent on when Apple events starts generating 
memory errors. 1 haven't done exhaustive research on this, 
but it does vary from machine to machine. Most servers 
handle 60K replies just fine, but some will crash when you 
try to pass this much data. I wouldn't recommend trying to 
send any more than 50 to 60K just to 1>e on the safe side. 

4) When a CGI isn't already running, WebSTAR will launch it 
when it is needed, so some CGIs quit after every rime they 
are executed. This causes a few seconds of delay while the 
CGt launches, but may not be an issue if the CGI is 
executed only very rarely. The other problem with 
launching CGIs on the fly is that you may encounter 
problems starting up. Out of memory errors and other 
startup problems may cause modal dialog boxes to be 
displayed, which may cause the server to halt. 

Advanced Topics 

Well, now you have plenty to get started building Wclxbascd 
applications in C. I here is more to learn, though, once you 
have had a few successes. For one thing, StarNinc is constantly 
coming out with enhancements that make CGIs easier to use 


and more powerful. By the time you’ve read this, there will 
undoubtedly he new capabilities available to CGIs, but here are 
a few of die things that you will want to learn more about once 
you fee] comfortable with the basic principals: 

1) A URL that activates a CGI t as we have said, normally includes 
the name of the CGI. WebSTAR now supports “actions”, 
which allows you to define filename extensions that will 
trigger your CGL So T for example, if your CGI performs a 
database .search, you could map the CGI to a filename suffix 
of Tsrclf. Any URL that references a file ending with ’\srcff 
would lx* passed to your CGI. The file being referenced by 
the CGI doesn’t need to actually exist, in fact, it probably 
won’t. The URL will simply lx passed to your CGI and you 
will decide what to do w ith it. Very powerful stuff 

2) You can also now define a u Pre-processor* and a ^Post¬ 
processor* for WebSTAR. The pre-processor is a CGI dial 
gets every request before WebSTAR processes it. The CGI 
can choose to process the request itself or pass it back to 
WebSTAR For normal processing. The past-processor gets 
information about the request after WebSTAR is done 
processing it, which can be used to implement new logging 
methods or set off alarms for certain activity. 

3) WebSTAR will not only send Apple events when incoming 
requests need to lx processed, but will also respond to 
them. You can use Apple events to extract and update many 
of the configuration options in WebST AR, as well as perform 
other interesting jobs. That means that your CGI can 
manipulate WebSTAR itself Note that, in order to do this, 
you must be using an ACGL Otherwise, WebSTAR stops 
and waits for the CGI to reply, and can t respond to events. 

1) Finally, WebSTAR supports "server push" by allowing a CGI 
to return data to the client in multiple Apple events. This 
can be handy for applications where the data is being 
returned on a timed basis (like reports every minute) or 
where the data is being ga the red very slowly (as in 
searching a large database). This is also a way to gel 
around the file size limitation, because while each event can 
contain only 60k or so of data, you can use multiple chunks 
to send an arbitrarily large amount of data back to the user. 

Wrapping Up 

Now that you know- how C CGIs work, you'll want to get 
started. The fastest way is to visit my Web sitc T where you'll 
find “Responder", To get to the Maxum Web site, point your 
browser at “http://www.maxum.cotn/niaxum/". fit's at all the 
usual source cock* sites, listed on page 2 . as tvell. -jtkl 

Responder is a very' simple CGI that includes source code 
and a Code Warrior project that will get you starred very 
quickly. There is at least one other C CGI available so you 
might want to kx>k around to find what will work best for you. 
Responder is a bare-hones shell that is very easy to understand, 
and it w ill make sense to you, having just read this article, since 
most of the code listed here has been dip[xd from Responder. 
Have fun! 
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Macintosh Common Lisp 3.0 


An Old Language 
is New Again! 


MCL: The Rumor and The Truth 

For a while last year we all thought that 
Macintosh Common Lisp (MCL) was 
going to he abandoned. Apple had 
decided not to coni inue development of 
the product and there was no suitable 
replacement in sight, particularly for the 
new PowerMac computers, But Apple 
finally decided in sell the product to 
Digitool, Inc. Digitool started right off by 
commencing the development of two 
new versions of the product; the first is 
the new 68K version 3.0 (which, unlike 
the previous version 2.0.1 runs just fine 
on the PowerMac with the Modern 
Memory Manager enabled). Digitool is 
also working on a PowerMac native 
version of the product, which they say 
will be released later this year. 

Creating the PowerMac version is a 
fairly major undertaking, mainly 
because MCL contains an incremental 
compiler that generates native 68K 
code* MCL also relies on the memory 
management facilities of the (>HK family, 
and supports 68K-style floating-point 
computations. All of this will have to 
change for a native PPG version. But 


Digitool promises that the upcoming PowerMac product wiU be 
very efficient and fully compatible with even the latest 
PowerMac machines. 

The truth is that MCI* 3-0 is extremely efficient right now, 
even though it's running under emulation mode on my 
PowerMac 6100. It no longer crashes when 1 have the Modem 
Memory' Manager turned on, and it's happy to execute with VM 
turned on as well. 


So What Good Is Lisp? 

I see many messages from developers who surf the various 
online networks and it seems that many of these messages are 
devoted to discussions of the various problems with the C++ 
language. In fact, many have expressed that C++ is an 
“abominable" language, full of pitfalls and traps. 

But Lisp is not without its own detractors (those who 
bemoan its copious use of parenthesis), but the fact is that 
few ever complain about limitations of the language. In fact, 
Lisp (ANSI Common Lisp, that is) is so full-featured and 
siraightforward that the main body of complaints are focused 
on the breadth of the language, rather than its limitations - 
it's such a large language that learning all of its features is 
almost impossible. Although the language is said to be quite 
large, it's not because of its syntax; that part is simple. The 
difficulty lies in learning the hundreds of standard functions, 
macros, and special forms thaL are documented in the 
Common Lisp standard. 

Once you spend some time with Lisp (and especially MCL), 
you'll begin to see the tremendous potential of the language, 
MCI. appears to be interpretive, but it is actually compiling each 
statement you type into native code (68K code, presently) as it 
Ls entered. If a particular set of statements is executed a second 
time, it is not recompiled, but is executed directly. You can 


Kit:h Parker - Rich Parker is a Ixxik author and software developer. He spends his days (and nights) writing programming 
hooks for horh the Macintosh and Windows platforms. His laresr book is called “Mastering the THINK Class Library Using 
Symantec C++ and Visual Architect." He is also a lover of all computer languages, especially object-oriented dynamic 
languages. When not writing or programming, Rich likes to read high-tech novels and fly Iits A-10 and h/A-18 Hornet flight 
simulation models. If you would like to write to Rich, asking a question or correcting a mistake, please feel free to do so. 
Rich can lx* reached on CompuServe at 76556,1132 or on the Internet at rparker@moa.com. 
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compile individual files of source text and store these into fast 
files, which load and execute very efficiently. 

You can build an application piece by piece, testing as you 
go } without having to go through the edit, compile, link, 
execute cycle that is standard with languages like Pascal, C, and 
C++, MCL is a prototyper's dream come Lruc. The language 
implements the full ANSI Common Lisp standard, including the 
Common Lisp Object System (CLOS). in addition, MCL contains 
classes and methods that implement all of the Macintosh user 
interface features, as well as almost all of the latest features of 
Lhe Mac OS. The product directly supports interfaces to over 
5000 traps, 1000 record definitions, anti 13,000 constant 
definitions, including support for WorldScripl, Apple events, 
Comm Toolbox, QuickDraw GX, QuickTime, and the Apple 
Open Collaboration Environment (AOCE), It also supports a 
“Foreign Function 11 interface that allows you to interface 
functions written in other languages to your MCL applications, 
MCL’s current Foricgn Function interface has some limitations 
(supports only model near) which Digitool reports will be 
addressed in the PowerPC implementation. 

And of course, MCL is a fully object-oriented dynamic 
language (OODL), so you can create functions that create other 
functions to your heart’s content. When an object becomes 
unreferenced, ir is disposed and the garbage collector will reuse 
its memory automatically. All of the latest fascinations in the 
computer science realm are provided with MCL. 

The ease with which applications can be prototyped is one 
of the major features of the product. Once familiar with the 
language, you can develop an application prototype in a matter 
of hours instead of days or weeks. Creating windows, nested 
views, dialogs, menus, and other Macintosh user interface 
features is a relatively simple chore. And the interactive 
debugging tools are also a great help in getting an application 
written anti ready to use. 

JusL to give you an example of what Lisp code looks like, 
Listing 1 is a simple MCL program that when executed creates 
a simple modeless dialog window containing a counter value 
as a sialic text item, and tw'O push buttons. When pushed, one 
of the buttons increments the counter and the other 
decrements the counter. The full source code to accomplish 
this is as follows: 

Listing 1* MCL Counter Code Example 

Counter 

;; define a global variable to hold the count value 
(defvar *value* 0) 

;; lncr item function called when Increment is clicked 

(defun incr-item (item) 

(if {<- *value* 999) 

Uetq * value* (1+ Value*))) 

(set-dialog-item-text item (format nil "-B.'GD" Value*))} 
deer-item function called when Decrement is clicked 
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OPTIMIZING COMPILER FOR 68K 

and PowerMac V ; 

Complete programming 
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NELLI! Uersion 2.8 - Supports PPC & Fat Binary 


PatchWorks 

Builds Updaters Without Programming 


PatchWorks has many options, but only one function: 
to create updater applications for distribution via public 
channels (e.g,, online services)- 

Before the advent of PatchWorks , creating an updater 
was a project in itself, one that consumed valuable 
programmer time which could more profitably be spent 
on revenue-producing projects. 

With PatchWorks , you create an updater in minutes. 
Since there's no coding or scripting, no bugs are 
introduced. Just fill in a dialog, and PatchWorks does the 
rest! 

Distribute updaters frequently to reflect maintenance 
releases, and watch your tech support and fulfillment 
costs fall dramatically 

Most important, your customers will know you care. 



Features 

■ Works with apps, INITs, cdevs, fonts, drivers, etc. 

• Now supports PPC, fat binary, & 4D apps 

• Customizable user interface 

• Updaters support multiple old versions 

• Resource compression (diffing) produces small updaters 

• Preserves personalization data (name, serial #, etc.) 

• Updater distribution is unrestricted & royalty-free 

Pricing: Begins at $195- Call for more information. 


SNA, inc. 

2200 NW Corporate Blvd. 

Boca Raton, FL 33431 

Tel (407) 241-0308 • FAX (407) 241-3195 



(defun deer-item (item) 

(if (> ‘value* 0) 

(setq ‘value* (I ‘value*)]) 

(tier-riInlog-iLem LexL iltm (format nil B -'3 I , 0D" *vaiue*))) 


;; create the dialog window and all of its subviews 

(make-instance ’dialog 

:window-title "Increment & 1Jeeremeut" 

:vi«w-sixe ^@(230 IDO) 
iview subviewa 
(list 

(make instance ’static■text-dialog-item 
:view-position #@(75 ID) 

:dialog-item-text "Value:") 

(make-instance "static text dialog item 
:view-posit Ion #@(120 10) 

:dialog item text "DOO" 

:view-nick-name 'value) 

(make instance "button-dialog-item 
:view-position #@(30 50) 

:dialog-item-text "Increment* 
tdielog-item-act I on 
#’(lambda (item) 

(iner item (find - named - sibling item ’value)))) 
(make instance "button-dialog-item 
:view-position #@(120 50) 

:dialog-item-text "Decrement* 

:dialog-item-action 
#'(lambda (item) 

(deer item (find-named-sibling item ’value)))))) 


The code in listing 1 is fairly self-explanatory. The first two 
function definitions implement the actions necessary to 
increment and decrement the counter. In this case, 1 have 
chosen to ensure that the counter value is always greater than 
or equal to zero. It is not allowed to become negative. This is 
an arbitrary decision - it could easily have been allowed to 
become negative and the tests would not be necessary in that 
case. When executed, the counter example appears as shown 
in Figure 1 ( with the Decrement button being pushed. The 
format function in the Incr-Item and deer-item functions 
causes the counter value to be displayed with leading zeros 
and with three digits. 


ids Increment G Decrement 


Ualue: 015 



Figure 1. MCI Counter Example During Execution 


New Features and a Face Lift 

When MCL is first placed into execution it opens a single 
"Listener” window into which you can type statements that are 
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u> he compiled and executed immediately. An example of the 
appearance of the Listener window after the Counter example 
was executed is shown in Figure 2. The question mark is MCL's 
standard prompt for input. The code for the Counter example 
was stored in a file and was loaded and executed by choosing 
the Load File command from the File menu. 


id! 


Listener 


We!come to Macintosh Common Lisp Mer-siom 3 0! 
7 

* CD IRLOG H I noremen t & Decrement” 12EFE51 > 


CL-USER| Idle 


HE® 


ih 

Ml 


f igure 2 , Listener Window Ap/xrarance 


The new version of MCL includes a number of new 
features and a major face-lift for many of iLs ‘Tool 1 * dialogs 
(many of which were quite ugly in the previous version), The 
Apropos tool window, which is used to find functions, 
variables, classes, or macros is shown m Figure 3- Both the 
appearance and functionality of this r<x>l is greatly enhanced in 
the new version, 



figure Apropos Tool Window 

The Apropos window shown in Figure 3 also shows the 
results of searching for references to window-related functions. 
The WINDOW-CLOSE function is highlighted in the list, 
indicating that it has been chosen by clicking on the entry. At 
this point, tire function can be inspected, callers of the function 
can be listed, or documentation for the function can be 
retrieved. If source code exists for the function, then that also 
can be shown and its methods can be listed, 

In addition to the Apropos tool, there is also a new Trace 
tool window. This tool is convenient for tracing the execution 


Online & CD-ROM Publishers: 


Broadcast’ 

Electronic Distribution That Works! 

Expand your market beyond the confines of traditional 
distribution methods and channels. Now you can offer your 
Customers software on demand, with Broadcast™. 

Sell Your Software Online 

Convert your online presence from a sup port/marketing cost 
center to a profitable distribution channel. Perhaps you a heady 
post "crippled" demos online, but have no means of follow- 
through, since the demos are downloaded anonymously. You 
can hope that subscribers arc favorably impressed; hope that 
they elect to purchase live software at some future date; and 
hope they complete and mail registration cards. 

Broadcast taps the enormous potential of online services as a 
sales medium, enabling you to convert passing interest into 
direct sales, by offering your products to subscribers at the 
precise moment when their motivation is at its peak. 

Sell Your Software on CD-ROM 

CD-ROM is an attractive storage medium. Broadcast 
transforms it into your most profitable sales medium. With 
Broadcast, you can publish your entire software line, with 
demos of each product, on a single CD, When a customer 
purchases one of your products, he or she is also exposed to 
your other products, and can unlock them, on demand, with 
a single telephone call. 

Broadcast Is easy to Implement In seconds. Broadcast will 
securely compress and encrypt your product, and embed it in 
an uniocker application that can be publicly distributed. To 
buy your product, a customer simply runs the unlocker. A 
unique control number is displayed, together with instructions 
and the telephone number of your sales desk. Your sales 
representative processes a credit card transaction and captures 
registration information. Using software we provide, the sales 
representative then generates a unique unlocking password 
for the customer. When the customer enters that password, 
the product is unlocked. 

Broadcast Is secure Our patent-pending technique takes a 
"thumbprint" of the user's system, and always requires a 
unique password. 

Broadcast Is Inexpensive Why give up 50 points or more (plus 
co-op) to a reseller, when you can sell direct at a fraction of the 
cost* No receivables, no cost of goods, no freight. Since 
customers try before they buy, you'll likely have no returns, 
either! 


SNA, Inc. 

2200 NW Corporate Blvd. 

Boca Raton, FL 33431 

Tel (407)241-0308 * FAX (407) 241-3195 
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or a number of functions when a program is being debugged. 
An example of Lhe appearance of this window and also the 
Listener window is shown in Figure 4. 


Preditor 3.0 



Text editing for your Macintosh. Preditor brings 
together Macintosh ease of use and a powerful set 
of features to give you the definitive editor. Con¬ 
tact us today and adopt Preditor for your machine! 



Also - check out our nitty hex-editor Snoop. 


4% E-Mail: evatac@acccss.digex.net 

^ WWW: hupV/wsvw.access.digex, 

T(\ MT/\/^ ^ net/'-evntacycvatac*html 

V riV/ \ I / ivy Voice: 703 620 0669 


Apple Guide 

Put the power of the leading 
on-screen help system to work for you 


We provide a full range of services to help you use 

this new technology most effectively. 

• Contract guide file development - give us your 
requirements and we will work with you to determine 
the best uses of Apple Guide in your application, 

•Development services - we can provide instructional 
design, content, scripting, and custom engineering 
to speed up your guide file development. 

* Technology transfer and training - we will help your 
staff develop Apple Guide expertise. 


Telephone: 408-395-1158 

COfltttCt Internet: powers@guideworks.com 
WWW: http://www.gii ideworks.com 



piHeUtorks, I1C 16373 Alexander Avenue Motile Sereno CA 95030 



Figure 4. Trace and listener Windows 


Figure 4 shows the results of tracing a single execution of 
the incr ^ it era function. The Trace window shows that the 
incr item function is to be traced and that its name and 
arguments arc to !>c printed (in the Listener window) upon 
entry, and that its value (result) is to Ik 1 printed when it exits. 
The results of the trace action are displayed in the Listener 
window, which is also shown in the figure. Any number of 
functions can be traced. The actions upon entry to a function 
can be to print its name and arguments, break (i.e.. halt 
execution and prompt the user to perform some action at the 
Listener prompt), or perform no action. The actions upon exit 
from a function can be to print its name and values (result), 
break to allow the user to perform some action, or do nothing. 

Actions at a break can include choosing to display the 
values of variables, modifying the source code, or any other 
related action. Other debugging aids, such as stepping die 
execution of a function, expression by expression, can be 
invoked by typing commands inio the Listener window. 
Execution can be easily resumed at a break by typing 
Command-/ into the Listener window. 

In addition to the tools just mentioned, MCI also includes 
an Inspector window. This is used to inspect the internal 
features of any MCL object or variable. You can either enter the 
name of the item to be inspected into the Apropos tool 
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Software Development By Professionals 


Macintosh software solutions for high technology and industrial businesses. 


Expertise in: 

■ Product Design and Specifications 

■ Prototyping 

* Software Design and Analysis 

* Programming 

* Re-engineering 

* Technical Consulting 


Experience allows us to he both; 

■ On Schedule 

■ On Budget 

State-of-the-art solutions for Macintosh. 

Quality and Reliability for all aspects of 
your project. 


-MysTic Riv/ER SoFtware 

64- Hemlock Street, Suite 2 'Arlington, MA 02174 * tele: ft 17/ft41-2828 * fax: ft J 7/641-1815 * CompuServe: 7 1320,2220 


window, choose the type of the item from the pop-up menu, 
and then click the Inspect button; or you can simply type 
(inspect item ) into the Listener and an Inspector 
window showing the appropriate features of the item will be 
displayed. Figure 5 shows the contents of the Inspector 
window when the variable * value* (from the Counter 
example) is being inspected. 


o 

Commands 

l b = 

Edit Value 

I Resample i 

Fixnui; 

16 



o 

Scientific: 

\. 60E+1 




Log base 2; 

4.0 




Binary: 

*b 10000 




0cta1: 

#o20 




Decimal: 

16, 




Hex: 

*x10 
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xot 




Character: 

*\P 




As a point: 
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Hbbreoia ted 

: 16 




As tise: 

16:00:16 Sunday t 3 1 December J 

1899 

<> 

noST-PUSITI 

UE-FIXHUM: 263436455 
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Figure 5. Insfwctor Window 

Figure 5 shows the contents of the * value* variable 
when (inspect * value*) is typed into the Listener. Notice 
that Lhe value is shown in many different forms, any of which 
might be of interest to you as the user. Other variations of the 
appearance of the Inspector window are common when 
different types of MCL objects are being inspected. 

MCL 3.0 also provides the ability to change quite a number 
of preferences. This is accomplished in a new Preferences 
window. This window is shown in Figure 6. 



Figure 6 . Preferences Window 

The Preferences window shown in Figure 6 includes a 
pop-up menu at its top that allows Environment (shown), 
Compiler, and also Printing preferences to be viewed and 
changed. Each of the preference items is a global variable 
(commonly written with leading and trailing asterisk characters 
to identify it as such). Each of the variables takes on a true or 
false value. The Documentation pane at the bottom of the 
window descril>es the selected preference variable’s function. 

Interface Development Toolktt 

MCL 3.0, like the previous version, offers a somewhat lame 
Interface Development Toolkit. This feature allows the 
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OraalHStall makes your installer choice easy 


Easy for your users 

DraginstaU's unique drag-and-drop interface makes installing your 
software a piece of cake for your users. And cuts down on tcch support calls. 

Easy for you 

DraginstaU's Builder utility allows you to create complex installers in minutes 
not days. And without the need to learn a complicated scripting language. 

Easy on your wallet 

DraginstaU's one-time fee of only $300.00 allows you to distribute an unlimited 
number of installers. No yearly renewals, no royalties, no hassle! 


To find out just how easy 
Draglnstall is, call us at 
1 - 800 - 890-9880 
to receive a free demo disk. 

Or contact us at: 

Ray Sauers Associates, Inc. 

1187 Main Avenue, Suite IB 
Clifton, NJ 07011-2252 USA 
Voice: 201-478-1970 
Fax: 201-478-1513 
E-mail: sauers^c arrotl.com 
http:/, www. c a r rol l .com, ctraginsta 11 



Script Debugger 

Script Debugger is a powerful and flexible AppleScript™ authoring tool dial makes 
it easy for novice and experienced script writers to get the most from AppleScript, 
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Scrip! Debugger 

m Offers true single-step execution of 
oi AppleScript scripts 

■ Provides a powerful scripting environ¬ 
ment that includes Drag l Drop editing 

■ Es Power Ft Not m 
m k scnptoble and attachable 



What the Scripting Gurus Soy About 
Script Debugger 
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Scnpt Debugger, it now ki 20 handlers, IS 
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development of simple application interfaces that consist of 
windows or dialogs containing buttons, text fields, and menus. It 
is dearly a limited facility and is one of the areas where MCI, 
could definitely be improved. While the tool is relatively easy to 
use and offers a point and dick approach to interface design, the 
numtxT and type of interface dements is very limited. Once an 
interface is designed, however, you can automatically generate the 
code to recreate the interface. In that respect, it's at least a help. 

Processes & Process Scheduling 

Version 3,0 of MCL includes the ability to create and schedule 
multiple processes. This feature facilitates the concurrent 
execution of computational tasks. When MCI starts up it creates 
two processes. The first, called “Initial," is responsible for 
processing events. The second, called "listener," is respoasible for 
accepting input from the user in the listener window (i.e., it runs 
the read-eva 1-print loop). Processes can have assigned priorities 
and processes with the same priority run in a round-robin fashion. 
Regardless of the priority assigned to a process, it will not am any 
longer than die time interval specified when the process was 
created, The status of all existing processes can be displayed by 
opening the Process window from the Tools menu. The 
appearance of the Process window is shown in figure 7. 
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Figure 7. Process Window 


Figure 7 shows that only the Listener and Initial processes 
currently exist. If the user's program had created other 
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Guide Composer 

Previewed at WWDC ‘95 

Develop Apple Guide files for any 
new or existing application 

Available from the Mae Tech Mail Order Store 


• No Programming 

• WYSIWYG Content Entry 

• Coach Marks 

• Index Terms 

• PICTs 

• Sounds 

• Integrated with Guide Maker Lite 
(included) For Easy Compiles 

• Optional Source Code Output 

• Change back from your $100 


Demo Available: Hr* A* ^ 

AppleLink, AOL, CIS* q) v7 

eWorld, Internet-Info-Mac Mac OS 

f-milr Ounpw in a Inkinrli e«T Slept; p Soflviaic. GujJc Muki b a indcnurt of Appfc Computer, Inc. 


STIP UP 

SOFTWARE 


7110 Glendora Avenue 
Dallas, Texas 75230 
214-360-9301 
214 360 0127 fax 


processes, thier names and their statistics would have appeared 
in the Process window as well. 

Locks are provided to enable multiple processes to be 
synchronized, A lock is like a semaphore. When one process 
obtains a lock, any other process attempting to obtain that lock 
will block until the lock has been released by the original 
owner. Processes can also be placed into queues, where they 
execute in the order in which they were entered into the 
queue. These arc major new features in MCL 3.0. 

Saving an Application 

MCL 3*0 has a new tool that makes the task of saving an 
application much easier than the previous save-application 
function call. 'Ibe appearance of the Save Application tool's 
window is shown in Figure 8. 



Figure 8. Saw Application Tool Window 


'Hie Application class, Menubar, and Error handler choices 
are selected from pop-up menus in the Save Application 
window. Values can be typed into the other corresponding 
fields. There is provision for the contents of a resource file to 
be copied into the application. The Disable compiler checkbox 
ensures that the application will not he able cn be used for 
development purposes, 

Digicool will also offer a “Redistribution Kit," for an extra 
charge, li should lie available by the time you read this. The kiL 
will offer the ability to truly excise rhe compiler from the saved 
application and reduce the size of the executable File 
significantly. 1 have no information about the kit, its cost, or 
any redistribution licensing costs at this time. You should check 
with either APDA or Digitool for this information. 

A Few Problems Have Surfaced 

Although the new MCL 3 0 produci appears very stable, a few 
users have complained of problems when using it, Apparently 
there is some sort of incompatibility with WorldScript 11 and 
Kanji Talk, although Digitool is unable to confirm this. Also, a 
couple of people have reported problems when running the 
new product with accelerator boards. There don't seem to be 
any serious problems with standard Mac computers (either 68K 
or PowerMac), except for the possible conflict with WorldScript. 

The Bottom Line 

l found MCL version 3*0 to be a great improvement over the 
previous version (10J). However, there are areas in which it 
could be improved. The Interface Toolkit really needs to be 
developed into a much more comprehensive tod. In addition, 
the existing debugging aids, while helpful, are not very friendly 
and lack the ease of use that other modern development 
environments provide. 


September 1993 • MacTechMagazine 


Macintosh Common Lisp 3,0 


51 






















































Bug Tracking the Macintosh Way 


TestTrack automates and simplifies tracking your bugs so you 
can concentrate on fixing them. Easy to set up, easy louse, 
and quick too! 

& Track bugs* change requests* testers, 
configurations* and more 

& Produce concise reports and charts 
& Automatically mulct bugs to team members 
1 Minimum setup time 
1 Multiple users* full security 


Available in September 


Tor more information, rail or send e-maif To fieapine@one,nct 



Svapine Software, Inc. 

HJfitfSopine Court 
Mainmlfc, OH 45033 
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QCi the Macintosh Testing solution, 

Subject your code to brutal stress 
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Or use QC during the development cycle to 
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invalid frlockMoves, writes to location zero, 
and more saving countless hours of 
needless debugging. 
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All in all, the MCL 3*0 product is a very worthwhile 
addition to your arsenal of tools. Its prototyping abilities are 
unexcelled and the overall breadth of the product is unequaled 
in any other environment. 

In addition to the product itself, MCL 3-0 comes with over 
200 megabytes of example code. It comes with die complete 
"Apple Programmer’s Toolbox Assistant 5 ' Quiekview application 
and database on the product's CDROM. 

The product is available only on CDROM; however, 
Digitool has placed disk images for the product onto the 
CDROM disc, so if you don’t own a CDROM drive and have a 
friend who has one* you can copy the disk images and then 
install the product from floppy disks. However, you’ll also lx? 
missing access to the over 200 megabytes of contributed code, 
so if you've ever wanted an excuse Lo buy a CDROM drive, this 
could lie it. 

The Redistribution Kit is $400 regular price, or $350 educational 
price. The MCL compiler may also lx licensed, as a scripting 
language in an application for example, for $2000, or $1600 
cudcational. MCL is $295, $135 for students. Digitoo!* Inc, One 
Main Street, Cambridge, MA 02142, (617)441-5000. 
email: into@digrtool.com 
web: http://www.digi tooleom 
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PROGRAMMER'S 

CHALLENGE 


By Bob Boonstra, Westford, Massachusetts 



Reversible Scrambling Algorithm 

According to tradition, September is Assembly Language 
Challenge month here at MaeTcch, and we continue that 
tradition this month. Your challenge is to do some simple 
arithmetic - raising a number to a power, and taking the 
remainder of the result modulo another number. Simple, 
right? To make things interesting, though, the numbers arc- 
going to be a little larger than you are used to dealing with. 
Hundreds of decimal digits long, in fact. "Why* you may 
ask? Well get into that in a minute, but there are a couple of 
hints in the title of this month’s challenge. 

The data structure to be used for the large numbers in 
liiis Challenge, and the prototype for the code you should 
write are: 

typedef struct BigNum t 

s ho rt n uMJi & : f* the number or bytes in the lHgNuni 7 

iiits i gne d char *dig: t tfig[01 is the most significant byte 7 

r diglmimDig J 1 is least significant 7 

1 BigNum: 

void PowerAndRetnatndnr £ 

BigNum *msg, 

BigNum • exp. f* calculate msg to the exp power, 7 
B i gNum * n. r take the remainder modulo n 7 

B i gNum * res P and store the result in res 7 

h 

For example, the value 1048573 (OxFFFFD) would be 
provided to you in a BigNum b with the values lxnumDig=3, 
b.diglOl = OxOF, bxiigUlHJxFF, and b.dig|2]=0xFD. The first 
three arguments will be provided as Input when 

PowerAndRemamder is called; you are to generate both 
elements of the BigNum struct for the res argument. The 
storage for all of the BigNums in the call to 

PowerAndRemamder will be allocated by the caller All 
BigNums will be positive integers, and none of the BigNums 


will be larger than 128 bytes in length (ie., h.mimDig will be no 
larger than 128). There is no restriction on the amount of 
memory you may use (within reason). 

Those of you with some number theory in your background 
may recognize what a function like this might l>c used for. If the 
modulus n is the product of two large primes p and q, one tan 
find values e anti tf for the exponent with the property that they 
are inverses of one another, but that neither can be easily 
derived from the other, provided prime numbers p and q are not 
divulged. If you calculate PowerAndRemaindetfmsg i e > n I c)i and 

I then calculate PowerAndRemainder(c t d,n ( x), then the result x 
turns out to l>e identical to the original value msg if e and d are 
relatively prime to (p-l)*{q-l). Now what do you suppose such 
a function might be useful for? 

Your solution may use any combination of ANSI C and/or 
68K assembly language, along with your choice of either the 
THINK C or Metro We rks C 68K compilers, 1 considered making 
this a PowerPC challenge, but 1 wasn’t confident that enough 
people are proficient with PPG assembly just yet - perhaps next 
September. In the meantime, you can look forward to a native 
PPG challenge next month. 

If you are interested in some sample values to test your 
code, send me email and 111 provide some. 

Challenge Deadline 

Several people wrote to point out that the deadline for 
submitting Challenge solutions was missing from the Rules lx)x 
during July and August, Unfortunately, when the rules were 
revised to accommodate multiple compilers and target 
instruction sets, the deadline was inadvertently omitted. The 
Challenge deadline remains the 10th of the month printed on 
the cover of the magazine, I received several submissions for 
the Chess challenge after the deadline (and after the article was 


Here’s how i\ works. Each month we present a new 
programming challenge here, First, write some code thai solves 
the challenge. Second, optimize your code (a lot). Then, submit your solution 
to MacTech magazine We choose a winner based on code correctness, speed, 
size, and elegance (in that order of importance) as well as the submission 
date. In the event of multiple equally desirable solutions, well choose one 
winner (with honorable mention, but no prize, given to the rujiner up). The 
prize for each month’s best solution is a tlOO credit in the MacTech Mail 
Order Store and a limited-edition, “The Winner! MacTech Programmers 
Challenge'* T-shirt (nor available in stores anywhere). 

Unless stated otherwise in the problem statement, the following rules apply: 
All solutions must be in ANSI compatible C Use only pure C code. We disqualify 
entries with any assembly in them (except for challenges specifically stated 
otherwise). You may call any Macintosh Toolbox routine (e.g., it doesn't matter if 
you use NtfwPir instead ol malice) Wd test entries with compiler options set to 
disable FPU use (for 680x0 code) and to enable all available speed optimizations. 
The compiler to be used and die target instruction set (680x0 or PowerPC) will be 


stated in tiie problem. Limit your code In 60 characters per line; 

this helps with e-mail gateways and page layout 
We publish the solution and winners for this month's Programmer’s 
Challenge two months later. All submissions must be received by the 10th 
day of the month printed on the front cover of this issue. 

You can get a head start on the challenge by reading the online version. 
We post it to die online services at the same time that we post source code. 
We make every effort to have it online no later Ilian when the magazines are 
mailed, but were unable to guarantee dial it will be online by any given date. 

Mark solutions “Ann: Programmers ClraJlenge Solution" and send it by 
e-mail to one of the Programmer’s Challenge addresses in the “How to 
Communicate With Us* section on page 2 of this issue. Include the solution, 
all related files, and your contact inlb. 

MacTech Magazine reserves the right to publish any solution entered in 
the Programmer’s Challenge. Authors grant MacTech Magazine die exclusive 
right to publish entries without limitation upon submission of each entry. 
Authors retain copyrights for the code. 
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submitted for publication)* Because of the problem with the 
deadline, I would have awarded points to any fast and correct 
entries, but all of the late entries had problems with correctness 
so no additional points were awarded. 

IVo Months Ago Winner 

Of the nine entries to the Sprite Blitz challenge, seven of them 
worked correctly. Congratulations to Xan Or egg (Durham, 
NC) lor having the fastest solution, some 30% faster titan the 
second place entry', submitted by John INcvard. Despite the 
variation in run lime performance, there were a number of 
clever and creative solutions among the top entries. 

Here are the times and code sizes for the entries that 
worked correctly. Numbers in parens after a person's name 
indicate that person's cumulative point total for all previous 
Challenges, not including this one. 


Name 


Xan Gregg (31) 
John Nevard 
Bill Karsh (71) 


Jim Buingardner (4) 


Jeremy Vineyard (40) 
Norman Basham 


Steve tsraelson 


time (68K) 

908 

1300 

3363 

3495 

578 9 

10164 

75846 


improvements in hardware performance make efficiency less 
important titan it lias been in the past. This is certainly a valid 
point of view, and there is no question that processor 
improvements have enabled us to sacrifice some machine 
cycles to achieve objectives other than performance. However, 
l contend that the performance of several popular personal 
computer applications demonstrates that software developers 
are capable of adding enough functionality (or generating poor 
enough code) to degrade performance to an unacceptable 
level, despite hardware advances. In my opinion, this will 
always be so. Certainly the techniques demonstrated in this 
column should not !>c used in all software, but they have their 
place in time-critical areas, and it is worth devoting more 
attention to efficiency than w r e typically do. Resides, squeezing 
instructions ouL of axle is great fun! But if you are interested 
in seeing a column that focuses on something besides 
efficiency, drop me a note. 

Top 20 Contestants of All Time 

Here are the Top 20 Contestants for the Programmer’s 
Challenges to date, The numbers below indude points 
awarded for this month's entrants. (Note; lies are listed 
alphabetically by last name there are more than 20 people 
listed this month because of tics.) 


Like most of the top entries, Xan composed his screen 
uyxlaies offscreen. Xan uses one offscreen G Wo rid to hold the 
background and another to prepare the next animation frame. 
One clever trick is that the offscreen image is large enough to 
contain all of a sprite that overlaps a window boundary, so that 
dipping need only be done when updating the window. 
Drawing is done directly to the screen, taking advantage of 
alignment conditions guaranteed to hold by the problem 
statement. Xan does all of his copying to the screen using 
unrolled loops, avoiding the overhead incurred when using 
Copy Bits or CopyMask for small copies. When reading the 
code, lake note of the switch statement in the COPY4 macro 
that copies the icon based on the value of the mask, and of the 
long word copies in the FastCopy Chunk routine. 

Bill Karsh pointed out in his entry that the relative 
performance of Copy Bits and Copy Mask varies between his 
68K machine and his PPG 7100* with Copy Bits being faster on 
the former machine and CopyMask being faster on the latter, I 
didn't have time to measure native performance on the 
PowerPC, but there was a 15% difference between the two 
versions in my 68K tests. Of course, as Xarfs solution shows, 
avoiding both can have its advantages also. 

Does Performance Matter? 

Pve received some email suggesting that the emphasis on 
performance in this column ought to be replaced by emphases 
on other things, like code portability, readability, reliability, 
encapsulation, or object orientation. The argument is that 


1 . 

[Name deleted] 

176 

2. 

Karsh, Bill 

78 

3. 

Munter, Brnst 

70 

4. 

Slenger, Allen 

65 

5. 

Larsson, GusLav 

60 

6. 

Gregg, Xan 

51 

7. 

Riha, Stepan 

51 

a 

Goebel, James 

49 

9. 

Nepsund* Ronald 

47 

10. 

Cutts, Kevin 

46 

li. 

Mallett, Jeff 

44 

12. 

Kaspurian, Raffi 

42 

13* 

Vineyard, Jeremy 

42 

14. 

Darrah, Dave 

31 

15. 

Landry, 1-arry 

29 

16. 

Clwertowski, Tom 

24 

17. 

l^ee, Johnny 

22 

18. 

Noll, Robert 

22 

19. 

Anderson, Troy 

20 

20. 

Beith, Gary 

20 

2L 

Buigoyne, Nick 

20 

22. 

Galway, Will 

20 

23* 

Israelson, Steve 

20 

24, 

Landweber, Greg 

20 

25. 

Pinkerton, Tom 

20 


There are three ways to cam points: (1) scoring in the top 
5 of any Challenge, (2) being the first person to find a bug in a 
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published winning solution or, (3) being the first person to 
suggest a Challenge that 1 use. The points you can win are: 


1st place ..,.,20 points 

2nd place .10 points 

3rd place ..7 points 

4th place.. ,4 points 

5Lh place.2 points 

finding bug ... 2 points 

suggesting Challenge ., , . . 2 points 


l lere is XajTs winning s< >lut a m: 

Sprite Blitz 

Xan Gregg July 1995 

r 

Since ‘correctness* is considered before speed in judging solutions, Uiis solution 
makes correctness the top priority at the cost of speed. 

1 use two offscreen GWortds. One hits the background, and another has the image to 
be displayed on the screen next. The ‘on deck” image is updated sprite by sprite, then 
it is copied to the screen for minimum flicker. 

The G Worlds are a little bigger t han the screen so I don t have to worn about sprites 
that overlap the edges until copying to the screen. 

Memory usage: 

2 GWorltb, each 64 pixels wider ami taller than window. 

IK of pixel data for each sprite. 

128 byto of mask data for each sprite. 

16 bytes of mfo for each sprite, 

l set the number of sprites to 400 The problem stares a maximum of 200 present al a 
time, but because a deleted Sprite stays around until the next Uptiate.ScreenO call, 

[ allow for 400 in case you delete all 200 then add 200 more before calling 
UpdatcScrccnQ Paranoid, but if you've got Uic memory. .. 

Assumptions not stated in the problem: 

Enough memory available for above usage. 

Window width is a multiple of 4 (confirmed by BB) 

Window lines not move during play. 


7 

^include <QDOffscreen,h> 

typndfif struct 

\ 

abort next Slots 

abort status: 

short width: 

short height: 

Point position; 

Point. lastPosition: 

} SpriteTnfo, *SprlteInfOPtr: 

typed tri struct 
f 

char pixData[i024]; 

] SpritePixData * * SpritePixDataPtr; 

typedef struct 

char maskData[l28] ; 

1 SpriteMaskDota. 'SpriteMaskDataFtr: 


iHdefine kMaxSprites 400L 

#define kMaxSpriteWidth 32L 

^define kMnxSpriteHeight 32L 

static CWiudowPir gSc.reenWindowP: 
static CWorldFu gBiickgroiindGW: 
static PixMapHandle gBackgroundPixMapH; 
static GWorldPtr gOuDeckGW: 


r ScriptWizard 


W,- 

Version 1.5 

Now shipping. With all die new features that you asked for. 

ScriptWizard™ is the best-selling script-editing and debugging 
tool that combines the power of a professional development 
environment with the ease of use that you expect of Macintosh® 
software. Script Wizard improves your productivity by delivering 
testing and debugging facilities that are as intuitive as they arc 
powerful including a Variable Watcher, true single-step debugging, 
rapid script navigation, and more. 

New features... 


* True AppleScript statement-level single stepping. 

* Scripiable and Recordable. 

» Improved text editing, with drag and drop. 

* "Native” for both Power Macintosh and 68K. 

* Quick access to Dictionaries from a new menu. 

* hull control over Toolbar position 6r visibility, 

■ Re-sizable- panes in windows. 

* Projector-aware for source code control. 

•Edit and debug scripts for FaceSpan 2.0, 

■ and much, much, more... 


US price 
still only 

$99 



US Orders: 800 799 4737 

Also available in the US from APDA, and Hvizer. 
Full Moon Software, internet: 'saltill mixing uni 1 
International Orders; Tel +44 1628 660242- Fax 666084. 


static 
static 
sialic 
static 
static 
static 
static 
static 
static 
slat ic 
static 
static 
static 
static 
static 
& la r 1 c 
static 
static 
static 


PixHapHandle gOnUeckPixMapH; 
short gLastSpriteSlat: 

short gFirstSpriteslot: 

short gSpriteCount; 

short gtfindowWidth; 

short gWindowHn tght; 

SpritelnfoPtr gSpn'tcTnfo; 
SpritePixDataPtr gSpritcPixftata: 
SpritehaskDataPtr ^SpriteMuskData; 
long gGnDeckRo vByt e s; 

P t r gt)n Dec kB a ae Ad d r; 

1 ong gHkgRnwBytes: 

Ptr gBkgBaseAddr; 

long gScreenRowByres; 

Ptr gSc reenEaseAdd r: 

Ptr 'gBkgKowAddr: 

Ptr *g0nDeckRowAddr; 

Pir *gScreenRovAddr: 

short gBelptionCarmt; 


void Start£ane(CtfindowBtr window?) 

( 

Reel r; 

PixJiapPtr bkgPixHapP: 

PixMapPtr onTtackPixMapP: 
PixHapFtr scrccfiP IxHapP: 

gLastSpriteslot = l: 
gFt rfltSpritaSlot = -1: 
gSpr 1 teCoutit = 0: 
gDeletionCotmt = 0: 
gScreenWimiowP ” window?: 
r = window? >porfRect; 
OftaetRectf&r, r.lcft. r.tnp); 
gWindowWidth “ r.right; 
gWindovHeight - r,bottom; 
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TnsetRcci (Ar. kMaxSpriteWidtb, kHaxSpriteHefghi}: 
Nc i wGWotld(tgBackgroundGW f 0, &r* 0, 0. 0); 
gBackgroundPixMapH - GetGWorldPixMap(gBackgrQundGW); 
LQCkFixels£gBackgroundPi xMapH): P locked 7 
NewGWorldf&gOnDeckGW* 0. fcr* 0, 0, 0); 
gGnOeckPixMapH ~~ GetGWorJdPixMap(gOnDeckGW): 
LockPixel s (gOnDeckPixMapll) ; P always locked 7 

gSprltelnlo ** (SpritelnfoFtr) NewPtrClear 
(sizeof(Spritelnfo) * kMaxSprltes); 
gSpritePixData = (SpritePixBataFtt) NewPtrClear 
(sizeof(SpritePixData) * kMaxEprites); 
gSpriteMaskDsta - (SpriteHaskDataPtr) NewPtrClear 
(sizeof(SpriteHaskBata) • kMaxSprites): 
gBkgRowAddr ~ (Fu *) NewPtrfsizeof (Ptr) * 

(gWiriduwUeight + kMaxSpriteHeight * ?,)); 
gOnUeckKovAddr ^ (Ptr *) NewFtr(sizeof(Pir) * 
CgWindowHeight i kMaxSprlteHeighl * 2)): 
gScreenRowAddr - (Ptr *) NewPu (sizeof (Ptr) 

* (long) gWlndowHeight )i 
if (gSpritelnfo 0 || gSpritePixData 0 

gSpr 3 toMaskData — 0 || gScreenRowAddr 0 
gBkgRowAddr == 0 || eOnDeckRowAddr — 0 
i gBackgroundGW — 0 ]{ gOnDeckGW 0) 
DebugStrCMp out of memory!*): 

InsetRect(£r. kMaxSpritoWidth t RMaxS p r it ell eight): 
0ffsetRect(&r* kHaxSprJteWidtli. kMaxSpriteHeight); 
CopyBits(A(( W indowPlr)window?) >portBits, 

H (W1ndowPir)gbackgroundGW)->portBits r 
taindottP >portRect. &r, srcCopy, NULL); 
CopyBitsU£(WindowPfr)window?)->portflits. 

& (£WiudovPt r) gOrtDeckGW) >portBits* 
&windowP->portRect * &r, srcCopy* NULL); 

bkgPixHapP - *gPackgrouudPixNapJ3; 

onOerkPixMapP - *gOnDeckFixMapH: 

gOiiIkn kRowBytes ® onDeckFIxMapP->rowEytes & 0x7iff: 

gOnDeckBaseAddr * onDeckPixMepP->bascAddr 

+ gOnDeckRowByt.es * kMaxSptiteHeight 
+ kMaxSprlteWidlh; 

gBkgRowByteK *- bkgP1xMapp->rowiytes & 0x7fff; 
gBkgBaseAddr » bkgPixMapF >baseAddr 

* gBkgRowBytes * kMaxSpriteHeight 
+ kMaxSpriteWidth: 

eoreenPixMapF * ‘gScreenWindowP->pottPixMap: 
gScreenKovBytes = screenPixMapP >rowBytes 6 Qx7fff; 
gScreenBaseAddr * scrennPixMapF >baseAddr 

- screen?IxKapP >bounds.left 

- screenPixHapP >boimds*top 

* gSereenRowBytes: 

f /' initialize niwAddr s 7 

long row: 

gOnDeckRowAtid r I = kKaxSpr i i eHei ght; 
gBkgRowAddr t- kMaxSpritelteigbt; 
for (row * kMaxSpritelleight: 

row < gWLndowlieight + kMaxSpriteHeight; row++) 

gBkgRowAddr [row] “ gBkgBaseAddr 

+ row * gRkgRowBytea: 
gOnDeckRowAddr [row] ~~ gOnDeckBaseAddr 
+ row * gOnDeckRowBytes: 

for (row ”0; row < gWindowHeight; row+O 
gHcreenkowAddr [row] - gScreenBaseAddr 
+ row ' gScreenRowBytes; 


P make a copy of Cleon's pixel and mask data 7 AddSpntc 

short AddSprite(GIconPtr dconP* Point startPt) 

t 

short slot: 
short i: 
short pixWidth: 
short tMskWidth; 
short pixRyics; 
short maskBytes: 


short bitBytes; 
short height; 

Ptr pixSreAddr* pixDstAddr; 
long "masksrcAddr. ‘maskDstAddr; 

slot - gLastSpriteSlot + I; 
if (slot “ kNaxSprites) 
slot = 0; 

while (gSpriteTnfo[slot],status != 0) 

I 

slot++: 

if (slot = kMaxSprites) 
slot “ 0; 

) 

gSpritelnfofslotl .status * 1 ;/*occupied*/ 
height " clconP-XiconPMap,bounds,bottom 
■ clconP ^iconFHap,bounds-top: 
pixWidth _ dconP >iconPMflp.bounds*right 
clconF■>iconPHa p.bounds.left; 
maskWidth — (pixWidth + 7) » %*. 
gSpritelnfolslot]*width ^ pixWidth: 
gSpriteInfo[slot].height * height: 
pixBytes = cIconP->iconFNap.rowBytes 4 0x7fff; 
maskBytes = dconP HconMask. rowBytes; 
bitBytes - clconP >iconBMap.rowBytes: 
pixSrcAddr = ((Ptr) fecIconF'>iconMaskDsta) 

+ bitBytes * height 
+ maskBytes * height 
+ 256 * 8 + &; rmi color tabic 7 

pixDstAddr = (char ') kgSpritePixData(slotl; 
maskSrcAddr = (long “) AcIconP->iconMaskData: 
maskDstAddr = (long *) AgSpriteMaskData[slot]: 
pixWidth - pixWidth >> 2; 
for (i = 0: i < height: 144) 

I 

{ 

register long l q = (long *) pixDstAddr; 
register long *p “ (long *) pixSrcAddr; 
register short j ** pixWidth; 
while £j > 0) 

f 

•q++ “ *pi4; 

j-: 

i 

I 

"maskDstAdrfrH- ^ *maskSrcAddr; 
pixDstAddr += 82; 
pixSrcAddr 4= pixBytes; 

inaskSrcAddr - (long *) (£(Ptt) naskSrcAddr) 

4 maskBytes): 

) 

If (gLastSpriteSlot >“ 0) 

I 

gSpritelnfo[gLastSoriteSlotl.nextSlot “ slot; 

I 

else 

t 

gFirstSpriteSlot = slot: 

) 

glastSpriteSlot = slot: 
gSprltelnfo [slotJ <nextSlot " 1: 

gSpritelnfo[slot].position = srarLPt: 
gSpritelnfolslot].lastPosit ion - startPt; 
gSpriteCount +4; 
return slot; 


t replace sprile with chunk frum the hkg gwortd 7 

static void EraseSprite(SpritelnfoPtr spritelnfoPj 

short numRows; 

short numCols; 

register long’p; 
register long*q; 
short h p v: 

register longsrcRowBytes: 
register longdstRowBytes: 


EraseSpriic 
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numRows * spriteInfoP>height; 
nunColR - spritelnfoP^width: 
h = spritelnfoP-MastFGsition.fa: 
v = spritelnfoP Hast Position.v: 
if (h + numCols (” 0 11 h >= gWindowWidth 
| | v + lUmRows <® 0 ] | v >- gWlndowHeight) 
return: f totally oflfeowm so slap it 7 

p “ (long *) (gBkgRowAddr[vj + h); 
q = (long f ) (gOnDeckRovAddr Iv] + h); 
s rcRowByl.es & gRkgRovBytes - numCols; 
dstRawBytes = gOiiDcekRowByT cs * numCois: 
if (numCois >= 16) 
if (minCols “ 32) 
l 

uhilft (numRows I" 0) 

t 

numRows ; 

*q++ = «p++ : 

*q++ = *p++; 

*q++ » *p++; 

*q++ - *p++; 

*qH - *pt+; 

•q+f - 'p++: 

*q++ - *pl4; 

* q++ = * p++; 

p = (long *) (((Pir) p) * stcRowBytes); 

q * (long •) (((Ptr) q) + dstRowBytes); 

I 

J 

el se 

1 

while (nunRows 1“ 0) 

1 

numRows- -; 

*q++ - *p++; 

*q++ - * p++; 

*q H - *p++: 

*q++ - *p++; 

p = (long *) ({(Prr) p) + stcRowBytes) : 

q - (long *) ([(Ptr) q) i dstRowBytes) ; 

1 

) 

else 

I 

if (numColft < 8) 
while (numRows !- 0) 

I 

numRows : 

*q - *p; 

p - (long *) U(Ptr) p) +■ gBkgRowBytes) i 

q « (long *) {((Ptr) q) + gOnOcckRowBytes); 

1 

el so t erase 4 pixels, even if its smaller 7 

while (numRows t" 0) 

I 

numRows ; 

*q++ = *p++; 

‘q+t - *p++: 

p - (long *) (((Ptr) p) + srcRovfiyi.es): 

q - (long # ) (((Ptr) q) + dstRowBytes): 

) 

\ 

) 
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short slot = gFirstSpriteSlot; 
short count - gDeletionCount; 

while (1) 

I 

if (gSpriLelnfo[slot!.status < 0) 

I r needs io be removed 7 
if (prevSlot >= 0) 

gSpritelnfolprevSlot].nextSlot 

= gSpritelnfoUlot].nextSlot: 

else 

gFl rBtSp riteS lot 

- gSpritelnfoIslot].nextSlotr 
if (slot = gLaitt. Sprites lot) 
gLastSpriteSloL “ prevSlot: 
gSpriteInto[slot!.sLaiys * 0 :/* available 7 
gSpriteCount-: 
count--: 

If (count = 0) 
break; 

I 


DekteSpriic 

1 Don* actually do the delete, just mark for deletion - because we still 
need To erase it in UpdateScrccnO 

7 

void Dele teSprite [short spritelB) 
f 

gSpritelnfo UpritelDl ^status " ■ I : t to be deleted 7 
gD«lfttionCount++: 


... RcmovcDclctedSprites 

t only called when there is at least one deletion 7 

static void KemuveDeletedSprIt as( void) 

{ 

short prevSlot • -1; 


else 

t 

prevSlot = slot: 

\ 

slot = gSpritelnfo[slot].nextSlot; 

I 

gBeletionCotmt = 0: 


void KoveSprite(short spritelD. Roint deltaPt) 

t 

gSprltclnfo [spritelD] .position.h += deltuPUh: 
gSpritclnfo [spritelD].position.v deltaFt,v: 


MovcSpnte 
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static void EraseGldSprites(void) ErascOldSpntcs 

short slot; 

SpritelnfoPtr spritelnfoP; 

slot “ gFirstSpriteSlot: 
while (slot >“ 0) 

( 

spritelnfoP = igSpritelnfo(slot): 

EraseSprite(spritelnfoP); 
slot = spriteInfoF">nextSlot: 

) 


/* copy 4 pixels based on Exits of die mask V 

^define C0PY4(q,p,m) \ 

switch (Cm) & 0x0 f) \ 

I \ 

case 0x0: break; \ 

case 0x1: "(q+3) * *(p+3); break; V 

case 0x2: 4 {q+2) ® 4 (p+2); break: \ 

case 0x3: *(short*J(q+2) - *(short*)(p+2); break; \ 

case 0x4: *(q+l) “ *(p+l>; break; \ 

case 0x5: *(q+l) - *(p+l); 4 (q+3) - 4 [p+3); break: \ 

case 0x6; "(short")(q+1) - *(short *)£p+l): break; \ 

case 0x7: “(q+1) - *(p+l); \ 

*(short*)(q+2) = 1 (short*)(p+2); break; \ 

case 0x8: * (q) * *(p); break; \ 

case 0x9; *(q) “ *(p); *(q+3) * *£p+3): break; \ 

case OxA: • (q) * Mp): 4 (q+2) - *(p+2); break; \ 

case OxB: *(q) * *(p); \ 

*(short")(q+2) - *(short 4 )(p+2); break; \ 

case OxC: * (short*) (q) ** * (short*)(p); break; \ 

case OxD: 4 (short*)(q) - 4 (short*)(p); \ 

4 (q+3) ~ 4 (p+3); break; \ 

case OxE; 4 (short*)(q) » *(short*)£p); \ 

Mq+2) - * (p+2); break; \ 

case OxF: *(Xong")(q) = *{long*)(p); break; \ 


//define COPt8(<j.p.mask) \ COT¥8 

C0FY4(q, p, mask » 4) \ 

COPY4(q+4.p+4- mask) 


static void DrawSprite(shott slot) DrawSpritc 


SpritelnfoPtr spritelnfoP; 
short numRows; 

short numCols; 

register Ptr p; 
register Ptr q; 

Ptr raaskP; 

short srcRowBytes; 

short h. v: 

short mask; 

short maskHask; 

sho r t ma s kR o vBy t e s; 

short nuraMaskBytes; 

short ij 

long dstRowBytes; 

spritelnfoP ■= SigSpritelnfofslotl; 

h - spritelnfoP-position.h; 

v * spriteInfoF~>position.v: 

numRows * spritelnfoP >height; 

numCols - spritelnfoP >width; 

p= (char ■) &gSpritePixData[sIot]: 

q " gOnDeckRowAddr[v] + h; 

maskP = (char *) fcgSpriteHaskData[slot]; 

if (numCols >- 8) 

I 

numMaskBytes " numCols » 3; 

maskRowBytes 3 4 numMaskBytes: 

srcRowBytes - 40 ■ numCols; 

dstRowBytes - gOnDeckRowBytes - numCols + 8; 


while Cl) 

I 

i = ntimMaskBytes; 
while £1) 

\ 

mask = *maskP+-+; 

COPtBtq, p. mask) 
if (-1 = 0) 
break: 

p += 8* 

q += 8; 

) 

if (--numRows — 0) 
break; 

inaskP += maskRowBytes; 
p += srcRowBytes; 
q -H* dstRowBytes; 

I 

\ 

else 

I 

maakMask = Oxf DO >> numCols; 
while (l) 

( 

mask = £*maskP) & maskKask; 
C0PY8(q f p, mask) 
if (-numRows — 0) 
b reak; 
maskP += 4; 
p +^ 32; 

q +^ gOnDeckRowEytes; 

i 

1 


static void BrawfiewSprites (void) OrawNcwSprilca 

[ 

register short slot: 

SpritelnfoPtr spritelnfoP; 

slot “ gFiratSpriteSlot; 
while (slot >= 0) 

] 

register short numRows; 

register sho rt mimCo1s; 

register short h; 

register short v; 

spritelnfoP = igSpritelnfofslot}: 
if (spritelnfoP->fitatus < 0) 

goto next Slot; f deleted so skip ii 7 
numRows = spritelnfoP kheight; 
numCols ” spritelnfoP >width; 
h = sprlteTnCoP >position*h; 
v “ spritelnfoP >poaition,v: 

If (h + numCols <- 0 |I h >- gVindovWidrh 
|| v + numRows <- 0 )| v >= gWindowHc!ght) 
goto next Slot; /* totally oflfscrcai 7 

DrawSprite(slot); 
nextSlot: 

slot - spritelnfoP->nextSlot; 

I 


r count is a multiple of 4 in the range 14..44] 7 351 m 

static void FastCopyChunk(long *q, long *p, 
short count:, short rows) 

I 

re gist e r short s rc RowB y t e s: 
register short dstRowBytes; 
register short rowsLeft ® rows; 
register short copyS - count 8: 
register short copy4 - count 6 4: 

srcRowBytes = gDnDeckRowBytes - count; 
dstRowBytes = gScreenRowBytes count; 
if (count & 32) 

( 
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while (cowsLefi > 0) 

I 

rowsLeft""; 

•q++ * *p++; 

*qH- ™ * p++* 

*q++ » 4 p++; 

*q++ - ’p++; 

*q-H- » * p++; 

* q-H- = 1 p++ - 
‘q-H- » *pH-; 

*q++ * * p++; 
if (copyS) 

1 

# q-H- - *pi+; 

*q++ ■ *p++j 

} 

if (copy4j 
•q-H- — *p++; 

p ” {long *) (((ftr) p) + srcRowBytes)’ 
q *= (long *) (((Ptr) q) + dstRowBytes): 
J 
I 

else if (count & 16) 


while (rowsLeft ) 0) 

[ 


rowsLeft**; 

* q 4f = *p+t 
•q++ * l p++ 
*q++ ~ *p++ 
*q++ = *p++ 

if (copy8) 
t 


*qi+ - *p++; 

*g++ - *p-H; 

\ 

if (copyA) 

•q-H- - *p++; 

p = {long •) ({(Ptr) p) + sreRowByi.es): 
q = (long *) (((Ptr) q) + dstRowflytes) ; 
I 


l 

else 


while (rowsLeft > 0) 

l 

rowsLeft-; 
if (copyB) 

t 

*q++ - -p++; 

•qH- - 4 p++: 

1 

if (copyA) 

*q++ * *p++; 

p (long *) (({Ptr) p) + srcRowBytesh 
q - (long *) (((Ptr) q) + dstRowflytes); 

\ 

I 

I 


Dra wNcwSpri resToScrtcn 

r Here we do have to watch out lor sprites that overlap the edges of the window. We 
copy a remngluar region that includes the sprites previous and current positions. Wc 
know they will be close sionce sprites move at most 8 pixels per turn. 

V 

static void DrawNewSpritesToScreeafvoid) 

\ 

short slot: 

SpriielnfoPtr spritelnfoP; 
short numRows; 

short numCols: 

register long *p: 

register long *q; 

short hStart. hEnd: 

short vStart, vEnd; 

slot = gFirstSpriteSiot; 
while (slot >“ 0) 
l 

spritelnfoP “ igSpriteinfo[slot]; 


numRows » spritelnfoP->height: 
numCols = spritelnfoP >width: 
if (spritelnfoP->position.h 

< spritelnfoP- MastPosition.h) 

l 

HStart = spriteInfoP->poeition,h: 

hEnd ~ spritelnfoP-HfistPositien.h + numCols: 

1 

else 

I 

hStart = spriteInfoP->lastPositioti;h: 
hEnd = spriteInfoP->position.h + numCols; 

I 

If (hStart C 0) 

hStarl m 0; 

else if (hEnd > gWindowWldth) 
hEnd ■= gWindowWid th: 
if CspriteInfoP->position*v 

< spritelnfoP-HastPosition.v) 

l 

vStart - spriteInfoP->position.v; 

vEnd ~ spritelnfoP-HastPosition.v + numRows: 

I 

else 

I 

vStart * spritelnfoP-MastFosition,v; 
vEnd = spriteInfoP">position.v + numRows: 

I 

if {vStart < 0] 
vStart = 0: 

else if (vEnd > gWindowHclgbt) 
vEnd - gWindowileight; 
hStart * hStart & - 4; /* make it a mult of 4 V 
hEnd = (hEnd + 3) 6 -4: /* make iu mull uf4 V 

p ® (long *) (gOnBeckRowAddrfvStartj + hStart): 
q = (long “) (gScreenRowAddrfvStattl + hStart): 

vEnd - = vStart; /* now it s a count 7 
hEnd hStart; r now it's a count 7 
If (hEnd >- 0) 

PastCopyChunkCq. p. hEnd, vEnd): 

spritelnfoP HastPosition - spritelnfoP->position; 
slot “ spritelnfoP >nextSlot; 


void dpdateScreen(void) UpdatcScrccn 

I 

EraseOldSpritest)- 
DrawNewSpritesO : 

DravNewSpritesToScreen E): 
if (gDeletionCount 1= 0) 

RemoveDeletedSpritesO: 

) 



To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

productinfo@xpIain.com 
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By John Kawakami, MacTech Magazine Editorial Assistant 


Apple Taps Guy Kawasaki For Apple Fellows Program 

CUPERTINO, California - June 1995 * Apple Computer, Inc, 
announced thaL Guy Kawasaki has been appointed to the 
company’s prestigious Apple Fellows program. The Apple 
Fellows program recognizes those rare individuals who have 
made extraordinary technical or leadership contributions to 
personal computing. Each Apple Fellow acts as a leader and a 
visionary, guiding the company in his particular area of expertise. 

A noted author, columnist and speaker, and the founder of 
various personal computing enterprises, Kawasaki has played a 
significant leadership role in the “evangelism" of the Apple 
Macintosh computer and its software. As an Apple Fellow, 
Kawasaki will represent developer issues and perspectives to 
Apple; work with developers on programs that enhance their 
businesses; and serve as a resource for Apple's sales, marketing, 
development, and support personnel. 

Prior to becoming an Apple Fellow, Guy Kawasaki was the 
president of Fog City Software in San Francisco, which he 
founded in 1994, Fog City is the creator of the Claris Emailer 
product, which Claris plans to ship in July. Kawasaki also was 
formerly a member of the board of directors of Macintosh 
software ventures Salient, Bit jugglers and BookMaker, and was 
the founder and president of ACI US, another Macintosh 
software company. 

While employed by Apple from 1983 to 1987, Kawasaki 
pioneered Apple's software evangelism program for the 
Macintosh computer as director of product management, and 
was responsible for managing the relationship between Apple 
and third-party developers, as well as Apple-labeled software 
produces. He was one of the key individuals responsible for the 
successful introduction of the original Macintosh computer in 
1984, and it was in this capacity that he perpetuated the term 
“software evangelist" in his highly successful efforts to support 
Macintosh software developers. 

“Guy Kawasaki brings extraordinary insight into Apple’s 
relationship with Macintosh developers and Macintosh users 
around the world," said David Nagel, Apple senior vice 
president of worldwide research and development. “As an 
Apple Fellow, Guy's experience as both a developer and a 
Macintosh software evangelist, as well as his enthusiasm for the 
Macintosh platform, will be a tremendous asset to Apple and 
the software-development community." 

"My goal is to carry the Macintosh torch and save computer 
users from the gates of hell," said Kawasaki. “MUD 
(monopolistic unshipped detritus) has replaced FUD (fear, 
uncertainty, and doubt). Personal computing should be about 


loftier tilings like empowerment, innovation, and creativity’." 

“This is an honor that is well deserved," said Tim Bajarin, 
president of Creative Strategies. “Because of Guy, Apple was 
able to hurdle many obstacles to gain developer acceptance of 
the early Macintosh. Facing similar challenges now r , Apple could 
not have chosen a more appropriate and responsive liaison and 
advocate for developers - someone who dearly understands 
and is trusted by the Macintosh developer community." 

“At Macromedia, we’re pleased to see someone with such 
enthusiasm and vision for the Macintosh rejoin Apple," said 
John C. “Bud" Colligan, president and CEO of Macromedia, Inc. 
“I can’t think of a letter-qualified person than Guy Kawasaki to 
catalyze and energize the Macintosh developer community." 

Kawasaki, age 40, is the author of several books - 
including “How to Drive Your Competition Crazy" and “The 
Macintosh Way" - and has been a contributing columnist for 
Macllser and Macworld magazines. 

Kawasaki holds a Bachelor of Arts in Psychology from 
Stanford and an MBA from UCLA. A native of Honolulu, Hawaii, 
he lives in San Francisco with his wife and son. They have 
another child in “beta." 

Apple CompuLer, Inc., http://www.Inf<xappie.com 


Apple Computer, Inc Mailing Lists 

Apple Computer, Inc, provides a number of mailing lists that 
can keep you informed of the latest information in the 
following areas. Any customer with an Internet email address 
or a commercial online service account with Internet email 
access can subscribe and unsubscrilx. 1 to any of the following 
mailing lists. 

Apple Press Releases - receive copies of all press 
releases created by Apple. To subscribe: Send an email 
message to: pressrel@thing2.info.apple.com ; In the body of the 
message, type: subscribe yourrealname (example: Subscribe 
Royce Walthrop) You’ll receive an automated reply letting you 
know you’ve been added to the list. 

Apple Information Alley - receive notification, a tabic of 
contents and the the text version of the Information Alley, 
Apple’s technical support journal, twice per month. To subscribe: 
Send an email message to: infoaitey@thing2Jnfo.appte.com ; In the 
Ixxiy of the message, type: subscribe yourrealname {example: 
Subscribe Royce Walthrop) You'll receive an automated reply 
letting you know you’ve been added to the list. 

Apple Software Updates - receive notification and 
descriptions of each new Apple software update posted to the 
Apple Software Updates areas on Apple supported online 
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services and Internet sites, including eWorld, Well also send 
you information on fee-based Apple software upgrades not 
posted online. To subscribe: Send an email message to- 
swupdates@thing2.info,apple.com ; In the body of the message, 
type: subscribe your real name (example: Subscribe Royce 
Walthrop) You’ll receive an automated reply letting you know 
you’ve been added to the list. 

Apple New Hardware - receive information on the newest 
Apple hardware releases, including Macintosh computers, 
printers, and imaging devices. All information is extracted from 
the Apple Tech Info Library, Apple's official technical support 
database, which is located in the Apple Technical Support area 
(shortcut: support) on eWorld. To subscribe: Send an email 
message 10: newhdw@thmg2.info.apple.coiTi ; In the body of the 
message, type: subscribe yourrealname (example: Subscribe 
Royce Walthrop) You 11 receive an automated reply letting you 
know you’ve been added to the list. 

Newton Press Releases - receive copies of all Newton 
related press releases created by Apple. To subscribe: Send an 
email message to: newtonpr@thing1.info.apple.com ; In the body of 
the message, type: subscribe yourrealname (example: Subscribe 
Royce Walthrop) You’ll receive an automated reply letting you 
know you’ve been added to the list. 

WON (World of Newton) Weekly - a weekly review of 
Newton platform information, software updates, online chats 
and resources, compiled by the Newton Platform Marketing 
group at Apple. To subscribe: Send an email message to: 
wonweekly@thmg2Jnfo.apple.com ; In the body of the message, 
type: subscribe yourrealname (example: Subscribe Royce 
Walthrop) You’ll receive an automated reply letting you know 
you’ve been added to the list. 


NetManage to Bring WinSock APIs to 
Apple Computer's Open Transport 

Mactivity '95, San Jose, California, July - NetManage, the 
leading Windows TCP/IP developer, announced its intent to 
bring the Window Sockets 1.1 APIs to the Mac OS. 

WinSock has emerged as the Application Programming 
Interface (API) of choice for accessing TCP/IP services on 
personal computers running Windows. By extending the 
architecture of Open Transport - Apple's new Mac OS 
networking and communications system - with Window 
Sockets APIs, tills proposed new developer tool will enable 
cross platform programming between the Mac OS and 
Windows, Windows/NT and Windows’95- 

Developers from the Windows community should find it 
easier to develop TCP/IP networking applications for the Mac 
OS, For corporate developers, these proposed new tools 
would provide a portable network API across both Windows 
and the Mac OS platform. As a result, customers should see an 
increased number of Windows networking applications become 
available on the Mac OS. 

“NetManage becoming a Mac OS developer, and 


announcing its intent Lo create this tool should further 
strengthen the developer proposition with Apple Open 
Transport", said John Mracek, senior director of System 
Software Marketing at Apple Computer, Inc. ’With tools support 
to be available for both POSIX XTI and Window Sockets APIs, 
developers will have the best of both UNIX and Windows for 
Mac OS network applications. We are particularly pleased to 
see NetManage working on tills. Their leadership and expertise 
as the contributor of the original WinSock specification certainly 
lays the groundwork tor a successful relationship." 

The two companies will release further details concerning 
the new tools at a later date. 


MacAnalyst and MacDesigner Tools Version 5-0 

Marshalltown, Iowa, July 1995 - Excel Software has introduced 
major enhancements to its suite of MacAnalyst and 
MacDesigner tools to automate the Booch 94, Fusion and 
Jacobson methods of object-oriented analysis and design. 

To retain its leadership role in OOA/OOD software 
engineering tools, improvements have been made to the 
existing support for OMT t ShJaer/Mellor and Coad/Yourdon 
methods. MacAnalyst and MacDesigner tools are currently used 
by thousands of software developers for personal computer, 
mainframe and embedded software systems. 

The Booch 94 method includes class, object, state, 
interaction, module and processor diagrams. These different 
diagram views are integrated through the multi-user team 
dictionary and requirement documents. Dictionary and 
diagram information developed during the design phase of a 
project is used for automated code generation of class 
structures and function frames. Integrated code browsing and 
editing provides double-dick access from design diagrams to 
source code. 

Jacobson method support includes use case diagrams and 
definitions, the analysis and design model, interaction diagrams and 
state transition graphs. The use case concept serves as the 
foundation of the Jacobson method and has become a popular 
supplement to other OOA/OOD methods. Each use case 
definition can be associated with other diagrams, tables or text 
documents for instant access. Class declarations and function code 
frames can be generated horn diagram and dictionary infonnation. 

Ollier features of version 5.0 include Harel style state 
models, instant access to requirement statements associated 
with a diagram or object selection and table generation from 
slate diagrams. Each product has a user’s manual, example 
documents and the new Introduction & Tutorials manual. The 
tutorials manual covers nineteen software engineering projects 
using a broad range of methods. 

Product pricing is MacAnalyst $995, MacAnalyst/Expert 
$1595, MacDesigner $995, MacDesigner/Expert $1595 and 
MacA&D $2995. These products run on all Macintosh 
computers with eight megabytes of RAM and System 7, A/UX 3 
or later. They are compatible with UNIX workstations using 
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is a collection of five menu defini¬ 
tion resources (MDEFs) /hat youjust 
paste into your project’s resource file. 

Build a menu using the MDEF and 
then just handle menu selections like, any 
normal menu. 


3ft rank 
C4i«r* 

DSC 11 Churl 
Thii Year 


Also contains Maitre d\ a special menu develoment tool 
that assists you in designing your MENU MILL Menus. 



- Use your drawing programs as programming tools 
* Fast unobtrusive RGB color picker 

■ Space saving Geneva 9 MDEF 

■ Calander Menu 


JUST 


$69.95 


Write r Ariel Publishing* Inc, 
11A Leisure Time Drive, 
Diamondhead* MS 39525 
Call (601) 255-6713 
FAX (60 l) 255-7086 


DEVELOPED B Y STAZ SOFTWARE, INC 


DEVELOPER 

% 

UNIVEHSnT 

It’s not just the basics anymore ! 

Advanced courses from Developer University 
get you up to speed quickly on new Apple rechnologiess 

□ OpenDoc 

□ PowerPC 

□ Newton 

U Graphics/Imaging 
Li Apple Guide 


Courses Available as 



Seif-Paced Classroom Lecture Online 


For more detailed information, cheek out our World Wide Web pages, 
http;Mw,info.apple.com, or contact the Apple Developer University Registrar 
at (408) 9744897 or fax (408) 9744)544, 

Uevdnper University, Apple Computer Ine. 1 infinite Loop, MS 4n>ITU. Cupertino. CA 95014 


Apple’s MAE software. Site licensing is available. 

Excel Software, Box J414, Marshalltown, IA 50158 
(515) 752-5359, Tax: (515) 752-2435, email: casetools@aol.com 


Metrowerks CodeWarrior Will Enable ISVs to Create 
Applications for New Interactive TV Operating System, 

Metrowerks, Inc. [MT% VSE: MWKj announced its intention to 
provide tools for developing software For use In interactive 
television (“ITV") in cooperation with PowerTV, Inc. and 
Scientific-Atlanta, Inc. A contract will be formalized shortly and 
the three companies plan to cooperate in establishing the 
Power TV operating system (“PowerTV OS”) as a premier 
environment for interactive TV content, 

The PowerTV OS is an open architecture technology 
selected by Scientific-Ad anla as ihe standard operating system 
for their digital settop terminals and is the operating system 
platform for a number for interactive applications. Industry 
leaders such as Ameritech, Pacific Telesis Video Services and 
Southern New England Telecommunications have all chosen the 
PoweflY OS for use in their interactive networks, 

Metrowerks will author and distribute a new version of 
CodeWarrior, its high-performance, easy-to-use software 
development package, to enable the creation of leading-edge 
content for the PowerTV OS. This new version of CodeWarrior 
will use the same tools, debuggers and environment that have 
made CodeWarrior a development system of choice for 
independent software vendors on the Macintosh, The PowerTV 
version of CodeWarrior will run on all Apple Macintosh and 
MacOS-compatiblc systems and will output code for the 
embedded PowerPC CPU used in the Scientific-Atlanta Digital 
Home Communication Terminal (“DHCT"). 

Metrowerks, email: info@metrowerks.com 


Script Deiu goer 

Late Night Software Ltd. announced the release of Script 
Debugger, hailed by company president Mark Alldriti as “a 
powerful and flexible AppleScript authoring tool that makes it 
easy for novice and experienced script writers alike to get the 
most from AppleScript,” 

Script Debugger is the first utility to offer true single-step 
execution of ail AppleScript scripts. It allows users to set 
breakpoints on any statement of Lheir scripts as well as step 
through their .scripts to see exactly haw they execute. 

Fully scriptable and attachable, Script Debugger offers an 
extensive list of features including Drag and Drop editing; a 
Dictionary window; and a handlers pop-up menu. 

Script Debugger is priced at $USI29 (plus shipping) and is 
available now. Late Night Software Ltd., (604) 929-5578, email; 
gtu bi n @ w i msey. com 
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MacRegistry™ Q 

Developer Job Opportunities 

If you arc a Macintosh developer, you should register with 
us! We have a database that enables us to let you know about 
job opportunities. When we are asked to do a search by a 
client company the database is the first place we go* * There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide. 

Marketability Assessment - To get a specific feel tor your 
marketability send a resume via Email or call. You may also 
request a Resume Workbook & Career Planner. 

Discreet - We are very careful to protect the confidentiality 
of a currently employed developer. 

Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place¬ 
ment services sind we arc Mac fanatics. 

1-800-231-5920 I das@spLeom I Fax 1-800-757-9003 


Scientific Placement, Inc. 




MT, box 19949, Houston, TX fttitA, TJ1-496&I0D I ax: 713496 0373 AOL: davesmalJ 

MT, Box 71. San Ramon, CA 94583 510-733-61643 both Aspics. bdt.com 

MT, Box 202676, Austin, TX 7 S72Q 2676 512-91E-3785 Icj ©zilker nc t 

MT, Kcnmorc Station, Box 13223, Boston, MA 02215 6t7424-S372 jen^spbos.pn.com: 

AppleLink: EH 5 SO: CompuServe: 71250,3091; eWorld: spi 




Work in 
Vtnationland! 


YOU DONT HAVE TO LIVE IN THE URBAN JUNGLE TO 
DO WORLD-CLASS PROGRAMMING FOR EXCITING PRODUCTS! 

A financially strong, rapidly growing software publisher, located in the heart aF 
"America's Vacationland," is seeking strong C programmers 
with experience writing commercial products for Macintosh. 

In addition fo o competitive salary and benefits, nnd challenging, 
high-profile work, youll enjoy the ehonce to live in a beautiful, low-cast 
community just a short drive from some of the nation's premier sporting areas 
and resorts. Live where most people only get to vacation. 

To apply, send resume in confidence to: 

Mark Swanson, Vice President, Software Engineering 
Advantage Learning Systems, Inc. 
P.0. Box 8036, Wisconsin Rapids, W! 54495-8036 



D V A N T A G 


I-earning Systems, Inc, 


lM-01 

m v 


fetter than 

our VP't 

Tswnami. 

(almost) 



MacXperts has openings for 
prdgTarmers experienced with 
C++ and Toolbox . If you have 
what it takes, and the desire to 
achieve, call Kendall iyler at: 
Voice: 800-156-8040 Fax:804-158-3847 
Internet: xperts^ridummd.hfl.iitt 
AOLMadperts Apple fin experts 
http 'Mm Hmaorpert5.com/- xperts 


Macintosh Contract 
Opportunities! 

As the oavsite provider of 
commot/tcmporaiy pasonnd to 
THF. computer OEM in 
Cupertino, California, we know 
where in find your next long-term 
contract! We staff all dungs 
Macintosh, with an increasing 
emphasis on software 
(Icvetopemm and SQA. 

The artmcctural and O/S 
evolution of your platform of 
choke is driving many new and 
exdting oppommkies! To register, 
please send or email resume. 



Adia Technical Services 
408 / 735-2902 

111 W. Evelyn Ave , #103 
Sunnyvale, CA 94086 
Fax; 408/245-6636 
cma N: 3diatcrh@ ix-netcocn.com 


-±jl±- 



The Trattner Network 

The Trattner Network, a digital talent source, Is looking for 
experienced Macintosh developers for a variety of consulting 
opportunities. Current projects include development in the areas 
of GpenDoc, Newton, Power PC t Metrowerks, PowcrBook, 
MacApp, 4D and many others. 

We have urgent needs for: 

* Software Developers 

* Hardware/Firmware Engineers 

* QA/QC Professionals 

* MuJtiMcdia Developers 

* Project Coordinator/Manager 

* Network Professionals 

The Trattner Network brings 10 years experience in the 
Macintosh consulting and placement industry, offering a unique 
blend of humanistic interaction and technical knowledge. 
Positions in Northern California and Nationwide. 

If you are looking for the chance to enhance your skills, team with 
the best, and make lots of money , send, fax or link your resume to: 

TTN 

Attn: Nyla Miller 

170 State St, Suite 240, Las Altos, CA 94022 
Phone (415) 949-9555 * Fax (415) 949-1026 
AppleLink: trat.net * email: nmiller®iramet.com 
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By Neil Ticklin, Ediior-in-Ch iej/Publisher 



Symantec Responds 

Dear MacTech readers, 

1 would like lo Lake a moment to address some of the 
concerns which have been expressed lately about Symantec. 

Guy Nicholas, in the July Issue, asked about supporting the 
standard SYM formal for debugging. You ean use liie external linker 
to produce SYM files now, but we acknowledge that tills is an 
incomplete solution. We expect to support the standard SYM format 
by Symantec Developers Advantage 5, available January, 1996- 

Frcd Johnson wondered about Pascal. There is no furllier 
engineering effort planned for HUNK Pascal Symantec does 
not wish to abandon it's Pascal customers, and we are working 
wkh Language Systems to provide a drop-in translator by 
January 1996. This strategy allows you to mix Pascal and C in 
the same project. Please contact me or Language Systems (703/ 
478-0181) for more information. 

If there are any other questions you have alx>uL Symantec, 
1 invite you to send me email at; 

wi verso n@ bed ford .Symantec .com 

Yours, 
Will Iverson 
Symantec Macintosh DevToob 
Evangelist & Ombudsman 


Go C fk C++! 

I found your July Dialog Box’ particularly entertaining, in part 
because it so well illustrates the myth about C t which you repeated 
in the words, There are definite advantages to C or C++ when you 
warn to get closer to the machine. 11 Unless you are programming 
for the PDP-11 (for which C is the quintessential high-level 
assembler) or a PDP-11-like computer (the 68K comes moderately 
dose; the PowerPC does not), this is just plain not true. But like 
the Mazda ads, “it feels gcxxl/’ regardless of the facts. 

The reason you have a Symantec Top 10 was clearly 
spelled out in the two letters; it’s necessary, it's less needed 
for Meirowerks, and not at all for Think Pascal. Anybody 
reading the column without deeply tinted rose-colored glasses 
quickly sees that it's mostly about recovering from language and 
implementation deficiencies. It also, no doubt, helps the 
MacTech bottom line by encouraging uneducated programmers 
to believe that this is the language of choice, so they must 
continually come back to the fountain for more help. The 
column may even perform a valuable public service by helping 
smart programmers avoid the tar-pit Ixdore getting stuck in it. 

Personally, 1 think C and C++ are wonderful languages, 


and I hope all my competitors make full use of diem ;-) 

- Tom Pittman 

{Let us he absolutely clear here - this is a public service 
announcement-program in Pascal, not Cor C++! <g>- Ed, nsfj 


From a Thread Initiated On Semper.fe.* 

/name deleted] wrote; 

>For most of us, ‘mentioning* Sys 6 in the same breath as 
>” Macintosh development" is bizarre. 

Again, the issue T raised wasn't about System 6.x in 
particular; it was about how Apple supports developers faced 
with the dilemma of adopting new technologies and yet 
supporting their existing customers. Maybe it’s easy to ignore 
System 6.x guys now that we are five years into System 7, but 
this is a general problem, one that’s only going to get worse. 

For yet another example, take System 8. Preemptive multi¬ 
threading is going to become more useful for some tasks in 
System 8, and yet System 8 (right now) isn’t slated to work on 
68K Macs. Certainly, 68K Macs aren’t where the “decisive 
action" is, and they wall be even less so in a year, yet 1 can’t 
imagine that most companies will be willing to abandon 7.x 
support. Especially since it will be ’98 or ’99 before the 
installed base of Power Macs equals that of 68Ks. 

So the question is, how do 1 write an app that Lakes 
advantage of preemptive threading in System 8 T and yet still 
works fine for most of my customers, and do this with a 
minimum of headaches? One partial solution is for Apple to 
provide System 8 for 68K Macs. Another is for Apple to 
establish good guidelines and sample code showing how to use 
preemptively multithreaded code in a non-preemptively- 
multithreaded OS. Maybe it’s possible, maybe iL’s not. But if 
Apple doesn't provide some kind of solution for us T then there 
is going to be a big delay in the arrival of preemptively 
multithreaded software, a delay Apple can’t afford. 

The rate of adoption of new technology does have a great 
impact on the outcome of the OS war. This means Apple needs 
to create good APIs, This means Apple needs to develop gotxJ 
developer tools. And this means thaL Apple needs to make it 
easy for developers to support existing customers during the 
multi-year transition. And if Apple doesn't provide System 8 
support for 68K Macs, there never will be a complete transition; 
well always have some 15 million 6HK/5ystem 7 Macs out there 
that most developers won’t be able to ignore. 
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As you point oul, good Mac people are .scarce. We all 
have limited resources. That is exactly why Apple should be 
the one to put engineers on this problem. It is far better that 
Apple deal with rhe issue of finding ways for developers to 
support new technologies and old users, than to have hundreds 
or thousands of us have to deal with it individually. That's a 
huge waste of Macintosh talent, and w ill be enough of a pain 
Lhat a lot of companies jusL won t adopt die new technologies. 

One more point. While we're fighting the OS war with 
new technologies and new ideas, let's not be outflanked. One 
of Lhe traditional benefits of the Macintosh is Lhat they are long- 
lived computers. Whereas PCs might have an effective lifetime 
of a few years, a lot of eight- and nine-year-old Mac Pluses and 
SEs are still in use. And, perhaps until recently, those old 
computers could still run a lot of modern software, 

As President of a User Group, I've heard a lot of users 
mark this as a benefit of owning a Mac. J'd hate to see us lose 
that benefit. I don’t think Apple and developers need to bend 
over backward to support System 6.x, but I also know that a lot 
of software out there can be written to support System 6.x with 
relative ease. Likewise, I guarantee a lor of people who bought 
(or are still buying 68K Macs) are discouraged to hear that 
Apple won't be bringing System 8, with all its great features, to 
their brand-new computer. 

A one-year-old computer and already unsupported? In my 
opinion, that is not the Macintosh way. 

Naliban Tennies 
Bootstrap Enterprises Inc 

P.S. No, my company isn't trying to corner the market on 
System 6.x users. However, I consider supporting these users, 
as much as possible, a mark of good programming just like fast 
execution speed and small code size. The dark side of the 
force is Microsoft, which often doesn’t seem to care about fast 
execution speed, small code size, or supporting users with 
older computers/operatmg systems (like those ancient, obsolete 
68030 users). 

Don’t give in to it. 


Pyian Doesn’t Stand a Chance 

I’ve just read the MacTech August issue’s Dylan article and 
have an observation to make: Apple's Dylan has zero chance 
of success in the commercial programming marketplace. The 
reasons why this is true have absolutely nothing to do with the 
nature of dynamic programming or of Dylan itself. 

First off, please understand that l am a fervent supporter of 
dynamic languages, and support the Dylan Lcam in much of 
their design goals. Dynamic languages solve many problems 
and offer new' solutions not allowed by the static languages in 
common use today. The leading language in object oriented 
programming, C++, not only suffers from its static nature but 
also from poor syntax design. C++ code and class hierarchies 
are as a result obtuse and brittle over the life of an application. 
Dylan solves many of these problems. 

The difficulties stem not so much from the nature of 
Dylan, but rather from the nature of Apple. It is unrealistic for 
Apple to propose and expect success from a proprietary 
programming language of their own design. Apple’s track 
record in development environments and languages is very 
poor. Developers such as myself who’ve heen with the 
Macintosh since the early days, have been rewarded by Apple 
with the destruction of their source code base. 

Early Macintosh code was developed almost exclusively in 
Pascal, but with ihe advent of the PowerPC Macintoshes Pascal 
was abandoned by Apple with no viable migration path 
provided. This lack of support of a company’s software 
development environment is outrageous and unheard of 
amongst major hardware arid software OS companies. Those of 
us with the will and desire to migrate to PowerPC are forced 
into converting our source code into C, a process that consumes 
much of a company’s development resources and results in a 
source code base that looks like it was written by Martians. 

Now r Apple trots out Dylan and asks the developer community 
to use it I, for one, will not. Even if 1 have U> jump through 
arcane hoops, I will use C++. At least I II be sine of the availability 
in ten years of development environments to build my code. 

Jim Gagnon 
Co-founder 
Abacus Concepts, Inc. 


DilberC by Scott Adams 
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Spare your fingers and find this list online at: 

http://www, ma ctech.com/ UR Ls. htm I 

Internet-related Material 

Bob httpY/bob. ncsa.ujuc.edu/ 

Consensus http://www consensuS.com: 8300 

C U-5eeMe httpY/toww j ungie.com/m^attlef/sc^tech/tompA! U-SeeMe/ 

Dig i Cash h ttprfwww. dig icash .com/ecash/ecash-home, ht m I 

In f o-Mac Searcher httpVMww, mid. netflN F0- MAC 

internet Config ftp://ftp. share, com/pubMemeHonfiguration/ 

Inter NIC http://www.intemic.nei/ 

ISP FAQ http://amazing.cinenet.net/faq.html 

ISDN page http://aiumni.caltech.eda/-dank/tsdn/ 

Peter Lewis ftp://amug.org/puWpeterlewis 

Lycos (Index of the Internet) http://I ytos.cs.onu.edu/ 

MacHTTP (see also WWW) 

Mailing List http//www.b 1 ap.com/macht 4 VmailingJist.html 

Registry http/Ztoww baineLconVape/machttpJalk/madi Upservers, by, machtml 

Extending MacHTTP 

h ttp ://www. uwte Washington ,edu/C om pu ting/WWW/lessons/START _HERE. ht ml 
Mac Web htt p://galaxy einet. net/EIN et/MacWeh/MacWebHome.html 

Matthias Neeracher http://eiT.ethz.ch/memhers/rteeri.htmi 

MERIT Searcher http://pubweb.nexQr.co.□k^ubtEC/mac/archive/wetcome.html 

OpenT f ansport/TC P gopher//seed ing. apple . com 

Gotland fipZ/ftp, outland.com/ 

Portable Net. Graphics hTtp//sansite.unc.edu/-boutell/png.html 

Ertc Scouten fTC P) http: //www, metro werks.co m/tepi p/i n dex, h tml 

SGML, Info http//Www. sil.org/sgml/sgmLhtmi 

C Parser ftp//ftp.|dark.com/pub/sgmls 

C++ Pa rser ftp//ftp, jd a rk .com/pu b/sp/ 

WWW, Jon W. Mac WWW Development Guide 

ht Ip //www. uwte. Washington .edu/C ompu ting/WWW/Mac/D i rectory. ht mt 
CGI demo/info blip //char lotte.acns. nwu.edu/maittools/ 

ftp://acns, n wu . edu/puh/jlnsluff/mailtools/ 

Intro, to WWW http://Www.eit.com/web/www.guide/ 

Web 66 http://web66.coied.umn.edLj/ 

Non-Mac servers http//www,w3,orgTiypertextA\WW/Librafy/Statiis.html 

Yahoo (Great index of the Internet) http://www.yahoo.com/ 


New Technologies 

AOCE ftp//ftp.andrew.cmu.edu/puh/aoce/ 

http//www. comri b .a nd rew. emu. edu/usr/jbbt/aoce/aoce. htm! 
Apple, ftp ftp://ftp.info.apple.com 

Web interface to ftp http //www. info .apple com/cgi-bin/lisler-pl 
DTS http/Avww. 1 nfo .appf e. com/dev/dts. ht mi 

Tech Notes http//www.info.apple.corT/dev/technotes/Main,html 

see also http//www,austm.apple.com 

Dylan http/Awww cambridge.apple.com/ 

see also ftp://cambridge.apple.com/pub/dylan 

see also http//legend,gwydion.G.cmu.edu:8001/dylan 

see also news://compJang.dy!an 

Mailing list archive ftp//cambridge.appie.conVpub/dylan/mail*flrchive/ 

Ma rials ftp://flp.ds. ufl.edu /puh/src/Marlais 

http7/www .cis. ufl. edu/-j n w/Ma ilae/ 

Mindy ftp://ftp.bdt.cor^/home/beard/Mindy-PPC sit, bin 

Kafeida htipy/www.kaleida.tom/ 

0 penDoc/Een to/SOM http//www .ci labs.org/pu b/ci I abs/tech/ 

hitpY/www. i nfo. a pple. com/dev/du/i ntro_to_opendoc/jod0 jndex. htm I 
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OpenDoc Part Ideas 

h ttp://www .eng.ud.edu/-s r oussey/N et Vision/software/od_parts/ 

OpenTransporl/TCP gopher //seeding apple com 

ftp://seeding.apple.com/ess/public/mactcp/MacTCP_Dev_Kit 
PowerPC http://power.globalnews.com/ 

Quickdraw GX, Apple hnp://www,info.appie.conVgx/gx.html 

Fanclub http://aah.resjdences.utaval.ca/quickgx/qoickgx.htmi 

Lawrence D'Oliveiro http://Www2.waEkato.ac.nz/idQ/gx/jndex.html 
Qu icktime http ://quiekti me. a pple. com/develop, htmi 

see also http ://www. i n fo.apple.com/dev/devi nfo/quidlinje/quickti me. b 1 ml 

Taligent http Y/Www ta I igent.com/ 

Other Programmer Resources 
4D http://www.netf.org/4d/4d.html 

Ada ftp://ftp.seas.gwu.edu/pub/ada 

Animation Class Library ftp://ftp.virtually.mcnet.ch/virtually/ 

Applescnpt ftp ://gaea, kgs. ukans edu/applescnpt 

SMUG http://www.bmug.org/ 

Bnan Bechtel http://www.info.appfe.com/dev/geeks.html 

Get 1 Resou rce h ftp ://www. a sel. udel. edu/-h ay nes/g 1 r.html 

Forth, MOPS http://www. netaxs.com/-j ayfar/mops. htm I 

Free Development Systems Faq http://www.europa.com/-sf/fdsm.htmI 

Robert Lentz http://www.astro.nwu.edii/lentz/mac/programmingfliome-prog.html 

Lisp, MCL http^/www.digitool.corn/ 

General httpy/www.G.rochester. edu/u/mi Her/alu, htm 1 

MacHack httpY/www.consen5US.com:80/-machad(/ 

see also httpVAvww. macgroup.com/MacHack.html 

MacTech f tp^/ftp. netcom, com/pub/xp/xplai n 

Matthias Neeracher http;//err.ethz.ch/members/neeri.html 

Matthew Xavier Mora http^/xavier. sri .com/umpg/u m pg. himl 

nick x good for beginning Mac in tosh programmers/ 

http ://www.pi tt.ed li /- n ick/ 
httpy/acacia. ens.fr: SOSO/home/pottier/i ndex.html 
news y/comp. sys.mac digest 
ftp 7/ftp .dartmouth. edu/p ub/esmp-digest 
ftp Y/ftp. netcom. com/pub/jo/jon pugh/homepage. htmi 
http ://www. i n f 0 wo rksho p.co m/-jo n pu g h / defaulthtml 
http://www, fa i rg ate.com /pa u I .shtm f 
http://www 1 nf o.apple .com/dev/devi nfo/macsourcecode. h tml 
h ttp://www. inf 0 .apple.com/dev/source/i ndex.html 
ftp Y/mac .archive, u mich. ed u/mac/develop men t/k>u rce/ 
ftp://ftp. switch. ch/sof l ware/mac/src/H T MiVWefcome.htm I 
http ://wo rid .std .co m/ - ctate/mac.htm I 
I tp ://daemon .nesa .uiuc. edu/TC U 
http ://rhmo. ha rvard.edu/d an/T C LArch ive . htmi 
http://w w w.csu fb >ed u / -be h e ves/xemd h ideou t/xemd hideouthtml 


Francois Fattier 
also 

Digests archive 
ion Pugh (AppleScript) 

Paul Robichaux 
Source code, Apple 
also Apple 
also UMich 
also M. Neeracher 
Christopher Tate 
KL 

see also 

XCMD Hideout 


Vendors, Products and Miscellaneous 


Aladdin HASP 

Alpha (text editor) 

BBEdil 

Celestin 

CIL 

Cyno Technologies 

Digitool 

Dilbert 

Drag Install 


http: / / www.hasp.com 

http: / / www.cs.umd .edu/ - ke teher/al ph a. htm I 

ftp ://ftp. netcom.com/pu h/bh/bbsw 

ftp ://ftp.tel e-port, com/vendors/cci/apprenti ce 

http://Vvww.dlabs.org/ 

http://www.cyno.com/cyno 

http ://Www. d igitoo I com/ 

http /Ajvww. u nited media .com/comics/d i Ibert 

http: //ca rrol I .com/d rag install 
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Tom En gel http: / / gasnet. med .y a le.ed u/demos/Tom 's_M acinto sh_Page. h tm I 

Economics Web http://t ucker.mech.ut3h.edu/ 

EduPage newsletter mailtoJjstpfQc@educom.edu 

in the body of the message put: subscribe edupage your name 
Chris W, Johnson http://gargravaiT.cc.uiexas.edu 

Graphical Business Interface http://www.gbi.com/ 

Genera] Magic http://Www.genmagic.com/ 

Global Village Communication http://www.globalvtllage.com/ 

Iconix http://www.biap.com/ltonix/ 

Steve Jasi k http://www.jasik.com/ 

Just Some Guy http7/www. spres.com/greg/ 

Language Systems http://www.langsys.com/langsys 

FTP site ftp://cais.com/pub/langsys 

MJ ND/IVfacD NS http V/cybercranx, techwood.org 

Madn tosh Vendor Directory http://rever nmsu .ed uMha ro/faqA/endor. html 

MacLI nQ http://www. wsmith. com / m adi nq/ 

Mac Netswitch http^/www. nd. ed iV-dwalton 1 / 

MacNosy ftp://ftp.netcom.cQm/puiyma/lmacnosy 

Metrowerks http ://www. m etrowerks.com / 

Motorola http ://www.moLcom/PowerPC 

NeoLogic http/Avww.neclogic.corR/'-neologic/ 

Newton http://newton.ujowa.edu/ 

PACE http://paceap.com/pace.html 

QKS/Smalltalk http ://www, qks.com 

QUED/M ftp^/f tp n isus-sa 11. com/pub/nisus 

see also hrtp://www.niSLis-soft.com/~nisus 

QuickCam 

httpi/www .ju ngie.com/msattler/sci' tech/com p/hardware/qu ickca m. html 

Rainbow Technologies http://www.rnbo.com 

StepUp Software http://rampages.onramp.net/-stepup/ 

Summit Software http://www.summsoft.com 

Symantec http://www.symantec.com/ 

Tenon (MachTen Unix) http://www.tenon.com/ 

TidBITS newsletter http://www, dartmouth edu/pages/TrdB ITS/TidB ITS html 

see also news://comp.sys.macdigest 

to subscribe mailto:lnfo@tidbits.com 

Time Tracker http://www,maui.com/-billm 

UserLand AutoWeb http://www.hotwired.conn/Statf/userland/ 

Verb Finder ftp://gaea.kgs.ukans.edu/frontier/oldstuff/VerbStack.sithqx 

The Well Connected Mac http://www.macfaq.com/ 


Internet 


One of the most useful indexes on the World Wide Web is 
Yahoo. You can explore Yahoo interactively by clicking on 
general categories and then more specific ones or you can 
enter key words and let the database search for items that 
match, Yahoo started as a project between two Stanford 
students, but is now a commercial venture with support from 
Netscape, Inc. This gives the database lots of horsepower and 
fast connections, 
http: //www.ya h oo.com/ 

Another good index to the Internet is Lycos, provided by 
Carnegie Mellon University. Lycos has over 5 million web 
pages in its database. Unlike Yahoo, which is annotated by 
humans, Lycos is generated automatically by a "Web Walking 
Robot”. This program traverses the World Wide Web link by 
link and indexes each page found. The database is huge, but it 
is a great place to look for things you think might be available 
on the Internet, http://lyc 05 .cs.cmu.edu/ 


Macintosh 


One of the tools I use most often has always been Symantec’s 
Think Reference, Apple introduced a similar, more current 
product called Toolbox Assistant (distributed by Addison 
Wesley), Even better, Apple places updates to both the 
browser and the databases on the Internet. Maybe well even 
see Open Doc and Copland references soon? 

Updates to Toolbox Assistant are at 
http://wwwjnfo.apple.com/dev/MPTA.html 

or if you prefer to FTP: 

ftp://ftp. i nfo, a p pie. com /App I e. 5u p po rtA rea/ Deve I o pe r Servi ces/Tethnic 
al_ Docu m e ntati on/T ool box_ Assistant_U pdates 

Brian Connors lias created a FAQ (Frequenly Asked Questions) 
about free development systems for the Macintosh, He’s 
created quite a list with lots of pointers to track down these 
eclectic programming systems. Lots of fun for those of us who 
like the weird and wacky! 
http://ww w.eu ro pa. com/-sf/fds m.htm I 

John Pugh has been busy updating his excellent page of 
programs he’s written, lie’s even gotten it on a real web 
server 

http://www. i nfo wo r ks h op.com / - jon p ug h / d ef a u 11. htm I 

Chris Fate has created a very nice page of links to lots of Mac 
resources on the net, A lot of them are mentioned above, but 
check them out on-line, 

http://worl d .std .com / -ctate / m ac.ht m 1 

Here’s a spot for all of you XCMD programmers, XCMDs are 
for more than HyperCard hackers, you knew, 

htfp://www,c5ulb.edu/“bch0ves/xcmdhideout/xcmdhideout.html 

Metrowerks, (my favorite compiler company) now has it’s ow n 
web site. They’ve got lots of gcxxl stuff including bunches of 
PowerPlant classes that people have contributed. 

http://www. metrowerks, com/ 


.Several security companies have Web pages available. If you’re 
interested in copy protection or secure remote access 
connections, here are some starting points: 

Aladdin HASP http://www.hasp.com/ 

Cyno Technologies http://www.cyno.com/cyno 

PACE http://paceap.com/pace.html 

Rainbow Technologies http://www.rnbo.com/ 


Remember to send any interesting Internet sites or corrections 
to URLs@mctech.com. 
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j j MAIL ORDER STORE 


MACTECH MAGAZINE PRODUCTS 
& ORDER INFORMATION 


E-mail, Fax, write, or call us. You may use your VISA, 
MasterCard or American Express; or you may send check 
or money order (in US funds only); 

MacTeeh Magazine. P.O Box >200, Westlake Village, CA 
93359-5200 • Voice; 805/494-9797 * Fax: 805/494-9798 

H you are an e-mail user, you 'can place orders or 
contact customer service air 

* AppleLink: MT.CUSTSVC 

* CompuServe: Tim^m 

* Internet cust^mcetxpLiin.com 

* America Online: MT CIJSTSVC 

* tiEnie: MACtECHMAG 

* eWorld: MT.CustSvc 

SUBSCHIFIIGNS 

US Magazine: $47 for 12 issues 

Canadian: $59 for 12 issues 

International: $97 for 12 issues 

US Magazine with Source Code Disk: $124 for 12 issues 

Canadian Magazine w/Source Cfxte Disk: $136 for 12 issues 

International Magazine w/So ufe| Code Disk: $194 for 12 Issues 

CD-ROM 

MacTcch CD-ROM, Volumes 110: Includes over 1230 
articles from all 115 issues (1981-19994 of MncTech 
iVlagazine (formerly MaeTurofl All article text and source 
code. NOW in THINK Reference format. Hie CD includes 
Symantec's 'HUNK™ Reference 20, working applications 
with full documentation, productdemos for developers and 
mom. See adveitisemenc, this issue: $49. Upgrades $39 
E-ma II, call or write for info, 

BOOKS 

The RcstqfMacTnior. Volume 1: Sold Opt 

The. Complete MatTutor Volume 2: Sold Out 

The Essential MacTulor, Volume 3: $19,95 

The Definitive MacTtrtur, Volume 4: $24.95 

The Best of Mac 1 utor f v olume 5: $ 3495 

Best (f MacTimr Cdkcton, Volumes 3 - 5: $69 

Best ofMacTiUnr, Volumes 6, 7, 8 & 9: Not available 

DISKS 

Source Code Disks: $8 each 
Topical Index f 1984-1991) on disk;■ $> 

MAGAZINE BACK ISSUES 

Volumes 3, 4 r 5, 6, 7, g T 9 and 10i $5 each (subject to 
availability) 

California residents include 8.25% sales tax on all 
software, disks and books. 

Allow up to 2 weeks for standard domestic ciders, mure lime 
for international orders. 

PLEASE NOTE 

Source code disks and journals ftosti MadTedi Magazine are 
licensed ro The purchaser for private use only and arc not 10 be 
copied for axumacial giin. However, the code contained 
therein may be included, if properly acknowledged, in 
commercial products at no additional charge. All prices arc 
subject to diange will 1 out notice. 



MACTECH FXauSrVES 


MacTech Magazine is your exclusive source 
for these specific products; 

Ad Lib 2.0 The premier MacApp 3.0 compatible 
ViewEdit replacement. A powerful user-interface 
editing tool to build views lor MacApp 3.0 and 3.1 
Ad Lib allows subclassing of all ol MacApp’s view 
classes including adorners, behaviors, and drawing 
environments. Siring and text style resources are 
managed automatically. Alternate display methods, 
such as a view hierarchy window, allow easy 
examination of complex view structures. Ad Lib 
includes source code for MacApp extensions fhai are 
supported by the editor - buttons can be activated by 
keystrokes, behaviors can be attached lo the 
application object, and general purpose behaviors 
can be configured lo perform a number of useful 
functions. Run mode allows the user to try out the 
views as they will work in an application. Templates 
can be created lo add additional data fields to view 
classes. Editing palettes provide fast and easy editing 
of common objects and attributes. Works with ACl's 
Objecl Master (version 2.0 and later) to navigate a 
project’s user interface source code. $195 

Frameworks Magazine: SB/back-issue, 
subject to availability. 

Frameworks Source Code Disk: $10 

per back issue, subject lo availabi lily. 

Five Years of Objects CD-ROM: Frameworks 
archives and source code from April 1991 to January 
1993, plus selected object-oriented publicly available 
software and demos. $95 

MADAC0N *93 CD-ROM: the highlights ol 
MADAC0N 93. including Mike Rote! on Pink, 
Bedrock, MacApp, QGDLs. and more, Slides, articles, 
demos, audio, and QuickTime. $95 

MAScript 1.2 adds support lor AppleScript 
to your MacApp 3.0.1 and 3,t based applications. Make 
your application scnptabte and recordable by building 
on a tried and tested Iramewnrk for object mode! 
support. MAScript dispatches Apple events to the 
appropriate objects, creates object specifiers, and makes 
framework objects like windows and documents 
scrfpfable and recordable, Sample application shows 
you how to begin adding support for scripting and 
recording. MAScript includes complete source code. 
Install MAScript by modifying one MacApp source file, 
then adding another lo your project. Future versions ol 
MacApp wilt incorporate MAScript, so MAScript 
support you add now will work in the future. $199 

The Mjtflner BETA System Is a software 
development environment supporting object-oriented 
programming in the BETA programming language. 
BETA is uniquely expressive and orthogonal. BETA 
unifies just about every abstraction mechanism - 
including class, procedure, (unction, coroutine, 
process and exception - into tie ultimate abstraction 


mechanism: the pattern, BETA includes: general 
block structure, strong typing, whole/part objects. 
The compiler: binary code generation, automatic 
garbage collection, separate compilation, interface to 
C, Pascal and assembler The system: persistent 
objects, basic libraries wiih containers classes, 
platform-independent GUI application frameworks on 
Unix, Mac and Windows NT, metaprogramming 
system. The tools available on Unix: the hyper 
structure editor supporting syntax directed editing, 
browsing, etc., and the source code debugger are 
currently being ported lo the Macintosh system. The 
Mjolner BETA System for Macintosh requires MPW 
(basic set) 3.2 or later. Package containing compiler, 
basic libraries, persistent store, GUI framework, and 
comprehensive documentation. (Other packages are 
also available) $295 

More Savvy includes all Savvy Mires plus 
Apple Event support (or all sub-classes of 
TEventHandler with extensive view support. Apple 
Event support for text includes text attributes and sub¬ 
range specification. Recordability supports additional 
actions, and coercion includes additional types. 
Additional clieni and server Apple Events. $450 


NEW Version 


I 


Savvy 1.1 0SA support 
Includes attachabitity, 


recordability, scriptability, coercion, in addition to 
script execution, idling and i/o. Apple Event support 
Includes complex objecl specifiers, synchronous/ 
asynchronous Apple Event handling, and Apple Event 
transactions for clients and servers. The Core Suite 
ol Apple Event objects is supported including the 
application, documents, windows, and files. 
Documentation Includes technology overview, 
cookbook, and sample code. $250 Savvy now 
supports MPW 3.1, 3.II and continues to support 
3.01, as well as supporting Mctrowerks CodeWarrfor. 


This month only, special offer - All Savvy 


versions include free copy of Savvy QuickTime! 


Savvy QuickTime Requires Savvy, More 
Savvy, or Super Savvy. Includes QuickTime, Apple 
Event, and view template suppcrl, Movies come out of 
the box ready lo play, edit, and read lo Apple Events. 
They can be included in any view structure, including 
templates, and are displayed in the scrap view Movie 
controls include volume, play rate, looping mode, 
display style, and other cfiaraeterislies. $250 


Super Savvy includes all More Savvy features 
plus compile, edit, and record scripts using built in 
script editor. View template editors, like Ad Lib, can 
attach scripts to view objects and modified scripts 
are saved with the document. Script action behavior 
allow quick access for executing and editing scripts 
attached to views. Text to object specifier coercion 
plus more. $700 


MacTecb Magazine is your exclusive source 
for available back issues of SFA ‘ s magazine, 
source code disks and assorted CD s. Caff 
for more info and pricing. 
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BOOKS 


Learn C on the Macintosh by Dave Mark. This 
self-teaching book/disk package gives you everything you 
need to begin programming on the Macintosh Learn to 
write, edit, compile, and run your first C programs 
through a series of over 25 projects that build on one 
another. The book comes with THIN C - a customized 
version of Symantec's THINK C, the leading programming 
environment for Macintosh 464 pages, Book/disk. 

$31,45 


Macintosh C Programming Primer Volume E, 
Second Edition, Inside the Toolbox Using 

THINK C by Dave Mark and Cartwright Reetl. This new 
edition of this Macintosh programming bestseller is updated 
to Include recent changes in Macintosh technology, 
including System 7, new versions ol THINK C and ResEdit, 
and new Macintosh machines. Readers will learn flow to use 
the resources, Macintosh Toolbox and interface to create 
Stand-alone applications. 672 pages, $ 38.96 $24.25 

Macintosh C Programming Primer Volume 
II, Mastering the Toolbox Using THINK C by 

Dave Mark. Volume II picks up where Volume I leaves off, 
covering more advanced topics such as: Color 
QuickDraw, THINK Class Library, TextEdit, and the 
Memory Manager: 528 pgs $ 36 05 $24.25 


C For Dummies," Volume 1 hy Dan Goodwin 
Finally! A hands-on. step-by-step tutorial for learning the 
essentials of programming in 0, $19 35 $17.95 

Macintosh Pascal Programming Primer 
Volume 1, Inside the Toolbox Using THINK 
Pascal oy Dave Mark and Cartwright Reed This tutorial 
shows programmers new to the Macintosh how to use the 
Toolbox, resources, and the Macintosh interface to create 
stand-alone applicalions wilh Symantec's THINK Pascal. 
544 pages $S-9§ $24.25 


rffflfTI Mastering the THINK Class Library 

*■■■■■ by Richard Parker. Now thal Symantec's long- 
awaited PowerPC native compiler is here, developers are 
taking another look at THINK This honk provides a 
thorough examination of Symantec's extensive Class Library 
and the Visual Architect, a graphic user interface 
development tool that allows you Eo produce commercial- 
quality applications with a minimum of effort. A complete 
description of the structure and operation of the TCL includes 
explanations of all code generated by the Visual Architect 
any necessary custom code, and the operation ol Ibis code. 
Visual Architect tutorials provide you wilh a step-by-step 
approach for simplifying the development of complex 
Macintosh applicalions. 496 pages $26.95 


C++ For Dummies"* by Stephen R. Davis is the all- 
in-one reference that gels you comfortable with object- 
oriented methods and up and running doing C++ 
programming! M $17,95 


Learn C++ on the Macintosh by Dave Mark. After 
a btlef refresher course in C, Learn C++ introduces the 
basic syntax of C++ and obied programming. Then youll 
learn how to write, edit, and compile your first C++ 
programs through a series Of programming projects thal 
build on one another as new concepls are introduced. Key 
C++ concepts such as derived classes, operator 
overloading, and iostream functions are all covered in 
Dave's easy-to-follow approach includes a special version 


of Symantec C++ for Macintosh Book/disk package with from I here to fully explore The Taligenl way" ol 
3,5' BOOK Macintosh disk 400 pages, $ 36 - 05 $33-26 programming, $17.55 


Programming Primer For The Macintosh* 
Volume 1 by John Whittle and Judy May This book 
provides an introduction to Macintosh programming, 
using C++ as the example language, and provides 
realistic, easy to follow, programming examples designed 
to work with either Symantec* C++ or Melrowerks* 
CodeWairior 6" Also includes one 3.5 H disk with source 
code for the programming examples, along with 
numerous, useful, public domain utifilies to use with each 
compiler, um $34.15 

Programming in Symantec C++ for the 
Macintosh by Judy May and John Whittle. This book 
will introduce you to object-oriented programming, the C++ 
language, and ul course Symantec C++ for the Macintosh 
You don't tiave to be a programmer, or even know anything 
about programming to benefit from this book. Programming 
in Symantec C++ for the Macintosh covers everything from 
the basics to advanced leatures of Symantec C++, ft you am 
a Think C or Zbrtecfo Ci i programmer who wants to learn 
more about object-oriented programming or what's different 
about Symantec On, there are chapters specifically for you. 
Includes helpful examples of C++ code that illuslrate object- 
oriented programs. $30 Ob $26.95 

Symantec C++ Programming for the 
Macintosh, Second Edition by Neil Rhodes & Julie 
McKeehan is Ihe perfect introduction to C++ programming 
- the most popular programming language lor the Mac! 
This updated edition is the easiest way to learn C++ in the 
Think environment, using many examples and hands-on 
coding experience. The official Symantec book, developed 
in cooperation with the Product Development staff. 
Provides valuable solutions, information, and advice for 
MPW programmers who are migrating to the Think 
environment. Disk includes source code from the book and 
example applications $41+09 $40.50 

Teach Yourself Mac C++ Programming in 21 
Days by Namir Clement Shammas is the easy to follow 
21 -day formal leaches readers how to program in C++ 
using the Symantec C++ compiler. It also shows readers 
how to develop GUI applications using the latest version 
of the THINK Class Library (TCL). Targets Symantec C++ 
7.0. one of the bottesl programming languages and 
development environments. Discusses the bastes of 
programming for the Mac using TCL and the Visual 
Architect utility Uses notes, tips, and warnings, as well as 
Q&A, Quiz, Exercise, and Do/Don't sections to teach users 
theC++ programming language mM $26,99 

Writing Localizabie Software for the Macintosh 

by Daniel R, Carter. 469 pages. $36* $24.25 

Taligent’s Guide to Designing Programs: 
Well-Mannered Object-Oriented Design in 

C++ is Ihe Taligenl approach to object-oriented design. 
The Taligenl Operaling Environment is the first 
commercial software system based entirely on objecl- 
orienled technology. Taligcnl's Guide to Designing 
Programs is a developer's-cye view of ihis system. IE 
introduces new concepts of programming and empowers 
developers to create software more productively. Out of 
their direct experience in developing the system, the 
authors focus on global issues of objecl-oriented design 
and writing C++ programs, and the specific issues ol 
programming in the Taligenl Operating Environment, 
Taiigent's Guide to Designing Programs assumes the 
reader is an experienced C++ programmer, and proceeds 


Software By Design: Creating User Friendly 
Software by Penny Bauersteld (Series Editor: Tony 
Meadow) This excellent reference provides readers with a 
thorough how-to for designing software that is easy to 
learn, comfortable to operate and that inspires user 
confidence. Written from the perspective ol Macintosh, 
but compatible with all platforms Stresses user Input 
from initial design, through prototyping, testing and 
revision. Provides tools for analyzing user needs and tesl 
responses Includes exercises for sharpening user- 
oriented design skills. W $26.95 

Macintosh Programming Techniques by Dan 

Sydow (Series Editor: Tony MeadnwJ This tutorial and 
handbook provides a thorough Inundation in the special 
techniques nt Macintosh programming for experienced 
Macintosh programmers as well as those making the 
transition from DOS. Windows, VAX or UNIX FmphasizBs 
programming techniques over syntax lor better code, 
regardless of language Guides the reader IhFouyh Macintosh 
memory management, QuickDraw, events and more, using 
sample program in C++. Disk includes an interactive tutorial, 
plus reusable C +1 code $3495 $31.95 

Macworld Ultimate Mac Programming by 

Dave Mark. Bestselling Mac programming author Dave 
Mark reveals the secrets ol Mac programming and 
presents important, timesaving techniques. 95 

$35-95 


Mac Screamer The Ultimate Macintosh* 
Supercharging Kit by Jan Harrington covers 30 
Macintosh models, including the Classics, LCs, 
PowerBooks, and Quadras and gives software solutions 
and hardware tips to accelerate Mac performance. It lets 
readers in on do-it-yourself lips that can save them over 
25% on upgrade costs $31.50 


A Fragment of Your Imagination by 

Joe Zobkiw. Here's some practical help for 


creating code resources and code fragments for the 
Macintosh and Power Macintosh Rather than simply 
gathering and indexing chunks of this vital code T the 
author provides thorough explanations to teach you more 
about hnw the Macintosh system functions as a whole. 
He aiso provides hard to find information about 
techniques used to structure and build tat, sate tat, and 


accelerated code resources for use on both 680x0 and 
Power Macintosh Ati code is reusable and is provided 
on the disc, along wilh Metrowerks Code Warrior Lite, 
Book/CD-ROM, 528 pages W* $35.95 


Mac Programming for Dummies" by Dan Parks 
Sydow takes the Intimidation and work oul of writing Mac 
programs. $4W6 $17.95 


Programming for System 7 by Gary Little and Tim 
Swihait. is a hands-on guide to creating applications for 
System 7. If describes the new features and functions ol 
the operaling system in detail. Topics covered include fife 
operations, cooperative multitasking, Balloon Help, Apple 
events, and the File Manager, Numerous working C code 
examples show programmers how to take advantage of 
each of these leatures and use them in developing their 
applications. 384 pages $24.25 


Guide to Macintosh System 7.5 by Don Crabb. 
Written by an industry expert, this is the first thorough 
book on the new and improved Macintosh operating 
system. Readers will team all the highlights of Ihe new 
System, including how to work efficiently with 
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applications, intuitive, task-oriented approach teaches 
topics the way users Ihink, not the way the machine 
thinks. Covers all the new leatures of System 7.5, 
including Powerlaik, PC Exchange, and MacTCP. Written 
by a world-renowned Mac expert, $36. W $22.50 

How To Write Macintosh Software by Scott 
Knaster is a great source for understanding Macintosh 
programming techniques Drawing from his years of 
experience working with programmers, Scott explains the 
mysteries and myths of Macintosh programming with wit 
and humor. The third edilion, fully revised and updated, 
covers System 7 and 32-bit developments, and explores 
such topics as how and where things are stored in 
memory: what things in memory can be moved around 
and when they may be moved: bnw to debug your 
applications with MaesBug; how lo examine your 
program's code to learn precisely what's going on when ft 
runs, 448 pgs mm $26,05 


Danny Goodman's Macintosh* Handbook 
Featuring System 7 by Danny Goodman with Richard 
Saul Wurman, This user friendly design includes a unique 
lour-colot design and exploded diagrams. It includes over 
100 spreads break dawn and clarify Mac problems and 
includes insider's tips, mm $26.95 


Real World Apple Guide, For The 

Mac is the much anticipated help and 
navigational aid component of Ihe new Apple System 7,5 
OS. The book is a practical introduction lo Apple Guide 
for programmers ft explains the design and function of 
Apple Guide, how to design your own guides using Apple 
Script. Comes with a disk of sample Apple Guides lor 
Apple Guide-compliant applications S30 05 $35,95. 


pjfffll Danny Goodman's Apple Guide 
“111 Starter Kit by Danny Goodman and Jeremy 
Joan Hewes Two highly respected experts offer a 
different approach for creating your own Apple Guide 
databases With Danny's Guide Starter program you 
can make guides quickly and easily, without having to 
learn a scripting language, write coded Hies, or use 
several different files and programs to produce your 
database (which is what you'd have to do without the 
program) The authors provide advice and rips on how 
to design a good Guide, from, planning and creation 
through testing, revising, and indexing Book/disk, 320 
pages, mm $31.45 


learn the underlying Proyraph language, how to use the 
power of lists, and the important aspects of the CPX 
classes and object editors. Includes disk with ail code in 
the book, mm $44.95 

Graphic Gems V Edited by Alan W Paeth is the 
newest volume in The Graphic Gems Series. It is intended 
lo provide Ihe graphics community with a set of practical 
loots for implementing new ideas and techniques, and to 
offer working solutions to real programming problems 
These tools are written by a wide variety of graphics 
programmers from industry, academia, and research. The 
books in this series have become essential, time-saving 
tools lor many programmers it is the latest collection ol 
graphics tips in The Graphic Gems Series written by Ihe 
leading programmers in the field. It contains about 50 
new gems displaying ihe most recant and innovative 
techniques in graphics programming. Also included is 
new gems in ellipses, splines, Bezier curves, and ray 
tracing Includes a disk which contains source code from 
all five volumes and is available in both IBM and 
Macintosh versions. CONTENTS: Algebra and Arithmetic. 
Computational Geometry. Modeling and Transformation. 
Curves and Surfaces. Ray Tracing and Radiosity 
Halftoning and Image Processing. Utilities, mm 
$44.95 

Danny Goodman's AppleScript Handbook 

Second Edilion by Danrry Goodman is a self-contained kit 
shows the reader how to customize and extend the 
capabilities ol any Macintosh computer - no programming 
experience needed! This enhanced and expanded edition 
of The Complete AppleScript Handbook focuses on putting 
AppleScript to work in all sorls ol practical situations. In 
addition, Danny Goodman's AppleScript Handbook. 
Second Edition shows you how to apply the same 
principles to other popular scripting systems, such as 
UserLand Frontier and QuicKeys. Shows readers how to 
use scripts to enhance the Macintosh environment, 
automate many processes, link data between applications, 
and much more. This hook provides a wealth of all mew 
examples showing how to integrate AppleScript with the 
Finder, spreadsheets, desktop publishing programs, 
graphics applications, databases, telecommunications 
programs, utilities, and HyperCard The accompanying 3 
1 /2* disk is jam-packed with over $100 worth ol software, 
including AppleScript 1.1, valuable utililies. and powerful, 
ready to-use scripts. mm $35,00 


HyperTalk* 2.2: The Book Second Edition by Oan 
Winkler, Scott Kamins, and Jeanne DeVotc is the most 
complete, authoritative source on HyperTalk 2.2 
programming and troubleshooting. It covers each 
language element of HyperTalk 2.2 (including the odd 
quirk or hug) $35.00 $31.50 

The Complete HyperCard* 2.2 Handbook 
Fourth Edition by Dariny Goodman is the biggest- 
selting Mac book - newly revised and updalcd for version 
2,2. It shows how to build working applications using the 
fates! version of HyperCard and covers text, painting 
tools, extension commands (XCMDs), scripting in 
HyperTalk, and more, mm $31.50 

Dan Shafer Presents the Power of Prograph 

CPX is a hands-on, project-centered approach to 
learning Ihe most revolutionary object-oriented 
programming language on the plane!. The language Kurt 
Schmucker likes best. The language that programmers 
actually report having ‘tun* programming. This 550-page 
book takes you step by step through three interrelated 
projects ol increasing complexity. Along the way you'll 


The Complete AppleScript" Handbook by 

Danny Goodman is a self-contained kit lo customizing 
and enhancing the Macintosh environment. The disk 
contains AppleScript 1.1 Runtime, Chang Labs 
TableServer, and useful, ready-to-run scripts. It also 
shows the Mac user how lo automate many processes - 
no programming experience necessary. $31,50 

The Taa of AppleScript: BMUG s Guide to 
Macintosh Scripting, Second Edition by Derrick 
Schneider & Hans Hansen. This updated bestseller is a 
complete, natural inlioduction to AppleScript programming 
essentials Readers learn how to customize applications, 
automate tedious tasks, and create programs without 
having to use a complex programming language 2 disks 
contain AppleScript, QuickTime, Stullll Lite, ResMover, and 
other helpful utilities. Progressive structure meets the 
needs of any Mac user, regardless of experience. 
Professional instructions are mixed with practical examples 
lor easy learning S3WJS $26,95 

Wireless For The Newton Software 
Development lor Mobile Communications by 
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Julie McKechan and Neil Rhodes is a book that picks up 
where Programming tor the Newton left off, teaching the 
reader how to develop Newlon® software on the 
Macintosh. The enclosed floppy disk provides a sample 
application, as well as a fully functional demonstration 
version of Newton Toolkit" (NTK*) r Apple Computer's 
complete development environment for the Newton*. 
Gives hands-on Newton environment training with sample 
code created specifically tor Ihe Newtorf* The authors are 
external faculty at Apple Developer University teaching 
classes on programming lor the Newton* Programming 
experience is assumed, although not in any particular 
language. Enclosed is a Happy disk which contains 
source code for a Newton application, as well as 
demonstration NTK" mm $3145 


Programming for the Newton Software 
Development with NewtonScript by Julie 
McKeehan and Neil Rhodes. Foreword by Walter R 
Smith Programming for Ihe Newton: Software 
Development with NewtonScript is an indispensable tool 
lor Newton programmers. Readers will learn how to 
develop software for the Newton on the Macintosh from 
people that developed the course on programming the 
Newton lor Apple Computer. The enclosed 3.5" disk 
contains a sample Newton application from the books, as 
well as demonstration version of Newton Toolkit (NTK). 
Apple Computers complete development environment for 
the Newtons. A Publication ol AP Professional May 1994, 
Paperback, 393 pp mm $26,95 

Metro werks Code Warrior Programming by 

Dan Parks Sydow Includes CodeWarrior Lite, and Full 
Coverage of PowerPlant™, The best inlormallon on 
Metrowerks CodeWarrior 6, giving full coverage to the 
Gold Edition. Even if you don't already own CodeWarrior 
6 , you'll still he able to work with Ihe examples in this 
book, using the CodeWarrior 6 Lite CD that comes with it. 
mm $35.95 

Optimizing PowerPC Code: Programming 
the PowerPC in Assembly Language - To take 
full advantage ol the potential of Ihe PowerPC, Developers 
need to master Ihe Assembly Language techniques. This 
book shows how to use the Assembly Language in 
PowerPC Programs lo produce faster more robust 
software $30. 9 5 $35.95 

Power Macintosh Programming Starter Kit 

by Tom Thompson. This is the first tutorial/reference 
tor programmers who want to enter the new world of the 
PowerPC chips Users find all the details on the new 
microprocessors, the new RISC architecture, and how to 
write native code and emulation operations to create 
their own software tor the Macintosh PowerPC. CD- 
ROM includes a unique compiler for writing code 
easily. The all-in-one book that gets programmers Ihe 
information and tools they need. Programming 
examples reinforce explanations of code and 
programming tools mm $35.10 

pwffll PowerBook™ The Digital Nomad’s 
““ Guide by Andrew Gore and Mitch Ratcliffe 
mm $2i.6a 


The ResEdit All Night Diner by David Ciskcwski 
An idea-filled menu and introduction to ihe joys ol 
customizing software - and adding personality to Ihe Mac 
with ResEditl Shows readers how to customize default 
icons, the text ol menus and dialog boxes, cursors, 
pointers, and more Provides specific recipes lor doing 
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creative things with Res Edit - plus howto avoid problems 
Disk features ResEdil program, plus lots oi sample 
resources mm $22 45 

ResEdir Complete, Second Edition by Peter 
Alley and Carolyn Strange With ResEdit, Macintosh 
programmers can customize every aspect ot their interface 
form creating screen backgrounds and icons to 
customizing menus and dialog boxes. 608 pages. 
Book/dEsk package. mm $31.45 

Sad Macs, Bombs, Disasters and What to 
Do About them by Ted landau comes to the rescue 
with your Macintosh problems. From fractious fonts to the 
ominous Sad Macintosh icon, Ihis emergency handbook 
covers the whole range of Macintosh problems 
symptoms, causes, and what you can do to solve them, 
540 Pages mm $22.45 

Macintosh* Crash Course by Glenn 8rown shows 
Macintosh power users what to do when things go wrong 
with their system Macintosh Crash Course shows 
readers how to overcome Macintosh system crashes, 
system lock-ups, and various, frustrating and cryptic 
error messages they regularly encounter. It includes a 
CD-ROM with shareware and freeware to help the user 
diagnose and repair system failures Includes up-to date 
coverage through Macintosh System 7.5. Managing 
memory. Hardware diagnostics. Fite recovery, 
PowerBook problems, PowerPC problems, network 
utilities, hard drive repair utilities, SCSI problems, 
conflicts and solutions and File synchronization and 
utilities. M $26,95 

Multimedia Authoring: Building and 
Developing Documents by Scott Fisher addresses 
line concerns that face anyone trying to create multimedia 
documents It offers specific advice on when to use 
different kinds of information architecture, discusses Ihe 
human-factors concepts foal determine how readers use 
and retain information, and them applies these findings to 
multimedia documents, covering the high-level issues 
concerning planners and authors of multimedia 
documents as well as those involved in evaluating or 
purchasing multimedia platforms. Includes one 3.5' high- 
density disk. U44& $31.45 

Multimedia Staffer Kit far Macintosh by 

Michael D, MurEe. This hands-on book offers the latest 
and greatest In mullimedia loi the Mad Readers team 
how to design their own multimedia projects step by 
step, then try it themselves with the demos, graphics, 
dips, and sample projects on the CD-ROM! CD-ROM 
contains QuickTime, sound and graphics clips and 
utilities, sample projects, and more How to choose and 
use a variety ot Macintosh mullimedia tools and 
presentation environments. Includes demos of Adobe 
Illustrator, Premiere. Heizer Sotlware programs, and more 
mm $27.oo 

QuickTime Starter Kit for Macintosh by Robert 
A. Letlieri & Judith Stern. This is the ultimate package for 
gelling productive and having fun with Macintosh movie¬ 
making Easy steps and valuable software help readers 
play, make, and edit QuickTime movies, CD-ROM 
includes QuickTime tools, movie clips, shareware, and 
demos of Premiere and other programs. Written by 
members ol the respected Berkeley Macintosh User 
Group Tips on the best ways to bring livc-actron video to 
Mac multimedia $40.50 

Adobe Premiere lor Macintosh: Classroom 
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in a Book, Second Edition by Adobe Press This 
is the updated edition ol Ihe official Adobe training 
workbook! Covering all the essential features of this 
video editing software, this book/CD-ROM set features 
twenty tutorial lessons to guide teachers and students 
through the magic of Macintosh moviemaking. CD-ROM 
Includes QuickTime movies, electronic images, and 
frames needed for Ihe workshop lessons In the bonk. 
Derailed yet easy-to-follow steps to crealing multimedia 
presentations, animation, and videos. Contains the latest 
information on litters, audio, superimposed dips, 
advanced editing, and more $4fl.OS $44,95 

3-D Starter Kit for Macintosh by Sean Wagstaff. 
The complete reference to 3-D graphics on the Macintosh 
-ideal lor beginning to intermediate product designers, 
illustrators, graphic designers, mu Hi media developers, 
animators, and video producers, as weft as architects and 
engineers! Covers more lhan 50 major Macintosh 3-D 
imaging software packages - Ihe most comprehensive 
book available. Lois of idea-packed examples that 
illuslrate how 3-D products work - individually and 
together CD-ROM includes sample models, image 
galleries, backgrounds, and textures, plus 3-D software 
tryout versions $40.00 $36.00 

Net Chat* by Michael Wolff & Co There are an 
estimated 35 million people online and most of them 
spend time chatting on the Net. Net Chat is the first 
comprehensive, discriminating guide devoted to the vast 
world of online Interpersonal communications, Following 
the successlul lormat of the ever popular Not Guide, Net 
Chat is designed for easy access, featuring an attractive 
layout, Informative illustrations, and thousands ol 
choices It is encyclopedic in scope - covers "chat" 
groups on the internet, all the major commercial services 
{including CompuServe, Prodigy, and America Online), 
and hundreds of bulletin boards It leaturcs a map of 
salons and meeting places in Cyberspace, where people 
stop to chat about politics, lifestyle, music, daling, sex. 
fantasy, health, family, and Just about everything 
imaginable! The entries include one- and Iwo-page 
spreads that describe Ihe lealured topic, and provide 
easy-access instructions, complete listings, and visual 
images Irom the Net For use with all computer plattorms 
- PCs. Macs, workstations WOO $17.00 

MORE Internet Far Dummies™ by John Levine & 
Margaret Levine Young. The expanded guide full of great 
Internet lips ter all those users who want to know where to 
go and what to do once connected. $17.95 

The Instant Internet Guide by Brent llestop and 
David Angell. An Internet jump-start - how to access, use 
and navigate global networks The Instant Internet Guide 
equips readers with the tools needed to travel Ihe 
electronic world. The book highlights ihe most important 
sources of internet news and information and explains 
how to access information on remote systems. It outlines 
how to use essential Internet ulilities and programs and 
includes a primer on UNIX lor the Internet 224 pages 
mm $13.45 

The Internet by Paul Hoffman gives the straight scoop 
on the Nei with the elegant, entertaining 4-color 
companion to the PBS special "The Internet Show: Color 
photos and illustrations explain Internet key features, its 
history, and trivia. Covers the basics and also a multilude 
of Interne! Information Services and extensive lists of 
Internet sites, mm $22.50 

The Internet, Deluxe Edition by Paul Hoffman. 
All of the brilliance ol The Internet plus the hot 


NetManage Internet Chameleon software 1 This bundled 
Deluxe Ediiion includes everything you need lo sort the 
Net! Fully automated, Nel Manage has pul together 3 
disks filled with Internet loots, service providers, 
applications, and more - an unbelievable value 1 $34 99 
$3150 

The Internet For Macs For Dummies~by 

Charles Seiter Now novice Mac users have an Internet 
guide written especially tor Ihem - in the easy For 
Dummies' 1 ® style they love $ 19.99 $17.95 

The Internet For Dummies'" 2nd Edition by 

John Levine and Carol Baroudl. Surl ihe net with ease 
using the up-to-the-minute new edition cl the #1 
bestselling Internet reference - now with friendly help on 
connecting to Ihe Internet $19.99 $17.99 

The Internet For Dummies™ Quick 
Reference by John Levine. This fact-tilted quick 
reference provides plain English explanations of Internel 
terms and basics Cross-referenced to 'The Internet For 
Dummies' $ 8.05 

The Internet For Macs For Dummies™ 
Starter Kit by Charles Seiter Access and navigate the 
Nei tike a pro ihe fun and easy way with this all-inclusive 
Starter Kit for Mac users. Kit includes a special edition of 
the bestselling The Internet For Macs For Dummies", plus 
two disks featuring The Pipeline and TCP/Connecl il* 
Extended software with, E-Mail, UseNet News Reader. 
FTP. Telnet, Gopher, and more! SLfo.OU $26.99 

Internet Power Tools by John Ross is designed for 
intermediate PC users, Internet Power Tools is a complete 
book/disk package that allows access lo the world's largest 
network - the Internet - with the same ease as one uses 
Windows The detailed Instructions allow readers lo find their 
way around the Internet Iasi and covers e-mail, file transfers, 
remote logon, on-line directories, and more The 
accompanying disk Es packed with powerful utilities, 
including Cello. PC Eudora, and Panda - easy-to-use 
graphical user interfaces (GUI) that obviate the need tor the 
obscure Unix line commands that everyone else must learn. 
II also provides access to even more software via Rarvdom 
House's Internet FTP site and shows how to conned to the 
Internet via a network connection or dial-in, $4MJ $36,00 

The 1994 Internet White Pages by Selh Godin & 
James S. McBride is (he one and only complete alphabetical 
directory of people on ihe Internet mm $ 26.95 

Internet SECRETS by John Levine & Carol Baroudi 
gives the mosl from the Nel with this performance- 
oriented book - lor Windows. UNIX, DOS, and Mac 
Internet users who know how to get connected hut want lo 
optimize their connections. $35.99 

Mosaic For Dummies; Windows Edition by 

David Angell & Brent Helsop. Learn lo use Mosaic with 
the only honk that explains Ihe most popular viewer of the 
World Wide Web in plain English Covers the popular 
Windows version of Mosaic. $17,99 

The Elements ot E-Mail Style by Brenl Heslop 
and David Angell Learn Ihe rules ol the road in the e-rnaii 
age Concise, easy-to-use formal explaining essential e- 
mail guidelines and rules. It covers style, tone, 
typography, formatting, politics and etiquette, tf also 
outlines basic rules of composition within the special 
context of writing e-mail and includes samples and 
templates for writing specific types of e-mail 
correspondence 208 pages mm $ 13,45 
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E-Mail Essentials by Ed I itlei & MarpreT Robbins is 
a hands-on guide to the basics of e-mail, the ubiquitous 
networks communication system. The honk is suitable tor 
both the casual a-mailer and the networking professional 
as it covers everything from the install on of e-mail to the 
maintenance and management of e-mail hubs and 
message servers The books exptains the fundamental 
concepts and technologies oi electronic mail, featuring 
chapters on Lotus applications and CompuServe, as well 
as information on upgrading, automation, message-based 
applications, and user training. E-mail Essentials is a step- 
by-step, jargon-free guide that will enable the e-mail user 
to get the most out nt the comm uni cat ton potentials of 
networking. 250pp. mm $22.45 


pWffl The Computer Privacy Handbook is 

a practical guide to e-mail encryption, data 
protection, and PGP privacy software With millions of e- 
mail messages and on-line discussions exchanged daily 
on the Internet, electronic security has become a key 
concern. The Computer Privacy Handbook explains 
practical steps individuals can take lo safeguard their 
electronic security. It also gives a vivid description of 
how the “Surveillance Ago' 1 threatens each person's 
personal security, a non-technlcal introduction into data 
encryption, and the U S, Government's Clipper Chip 
surveillance proposal I also provides an overview of 
PGP. (Pretty Good Privacy), the world standard for e-mail 
privacy $54-96 $22.45. 


America Online Far Dummies’ by John Kauteid 
"Driver's Education" tor this wildly popular on-line service 
- covering everything from the main menu to the mail 
groups lor Windows, DOS, and Mac platforms. Includes a 
coupon for free usage time on AOL for first-time users. 
mm $ 17.95 


CompuServe For Dummies" by Wallace Wang 
Find out how to shop, play games, join forums, get the 
latest news, do research, and more on this popular on¬ 
line service $43-96 $17.95 


eWorld: The Official Guide for Macintosh 
Users by Cary Lu & John Milligan. Discover the next 
generation nf online services - Apple's eWorld. Certain lo 
be a bestseller, this authorized guide lo contains the 
exclusive Apple software needed to connect to eWorld ft 
also provides a road map of eWorld and all of its features, 
and is the first and best book m this exciting new service 
Covers every aspect of eWorld, the next generation of 
online services Everything users need to get connected 
and get the most out of eWorld The only official Apple 
book and software for accessing eWorld, $9335 $26.95 


NEW! 


PowerPC System Architecture by 

MindShare This book describes Ihe hardware 


architecture of PowerPC systems, providing a clear, 
concise explanation of the PowerPC specification, the 
template upon which all PowerPC processors are 
designed. The author provides a complete description of 
the specification for both the 32- and 64-bit 
implementations. 656 pages $3495 $31.45 


PCI System Architecture, Third 
Edition by MindShare Describing revision 
21 of the Peripheral Component Interconnect (PCI) bus 
specification, this book explores PCI's relationship lo the 
rest of the system. It includes an in-depth treatment of 
PCI lo PCI bridges, the PCI BIOS, the 66MHz PCI bus, 
and more. 592 pages $3495 $31.45 


THE APPLE LIBRARY 


3D Graphics Programming Using 
QuickDraw 3D by Apple Computer, Inc. 


Now you can incorporate spectacular 3D graphics into 
your applications. This book/CD-ROM package explores 
QuickDraw 30, a graphics extension to the Mac OS for 
Power Macintoshes. The CD contains the complete 
QuickDraw 3D system itself and a complete database of 
Ihe QuickDraw 3D API, allowing you in slant access to the 
hundreds ol graphics calls via a fast viewing engine. 
Book/CD-RGM, 640 pages, mm $35.95 


Ffffffll Apple Guide Complete by Apple 
■■■■■ Computer, Inc, For those who want the full 
power of Apple's complete toolset, this book and CD- 
ROM package from Apple provides everything you need to 
produce guide files successfully, including Guide Maker, 
the software you use to build and tesl guide files. You'll 
team about the complete cycle ol designing as welt as 
advanced topics such as scripting and coding guide files. 
Book/CD ROM, 544 pages mm $35.95 


Inside AppleTalk by Gursharan S. Sidtiu. Richard F 
Andrews and AJan B, Qppenheimer. Apple Computer, Inc. 
650 pages $6495 $31,45 



AppleScript Finder Guide, English Dsatect 
by Apple Computer, Inc mm $17.95. 

AppleScript Language Guide, by 

Apple Computer, Inc, mm $26.95. 

AppleScript Scripting Additions 
Guide, by Apple Computer. Inc $17.05. 


HyperCard Stack Design Guidelines by Apple 
Computer, Inc. is an essential book tor everyone who 
creates Apple HyperCard stacks, Irom beginners lo 
commercial developers. It covers the basic principles of 
design Lhal, when incorporated, make HyperCard stacks 
effective and usable. Topics include guidelines, 
navigation, graphic design and screen illustration, text in 
stacks, music and sound, a sample stack development 
scenario, collaborative development, and the Stack 
Design Checklist. 240 pages, mm $19.95 

Macintosh Programmer's Toolbox Assistant 
CD-ROM - Instant electronic access to Inside 
Macintosh essentials. Now Macintosh programmers can 
get quick access to over 4,000 Toolbox calls that are at 
the heart of Macintosh system soltware The definitions of 
these data structures, resources, constants, and functions 
are documented in the Inside Macintosh series and are 
essential information for anyone developing Macintosh 
SDllware. Macintosh Programmer’s Toolbox Assistant is a 
CD-ROM lhal harnesses the power ol one of the best 
search and viewing engines in the Industry. It allows 
programmers to access the Toolbox calls quickly from 
their development environment. With hypertext links 
allowing programmers 10 view related topics easily 
Macintosh Programmer's Toolbox Assistant is the 
ultimate electronic reference tool for Macintosh 
programmers, $99.95 

Inside Macintosh: CD-ROM by Apple Computer, 
Inc. Inside Macintosh* is the essential relerence for 
programmers, designers, and engineers lor creating 
applications tor the Macintosh family of computers. Inside 
Macintosh CD-ROM collects more than 25 volumes in 
electronic form, Incfudlng: QuickDraw" GX Library. 
Macintosh Human interlace Guidelines, PowerPC System 
Soltware. Macintosh Toolbox Essentials and More 
Macintosh Toolbox, QuickTime and QuickTime 
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Components Now programmers will be able Io access 
over 16,000 pages of the information they need directly 
from their computers. Hypertext linking and extensive 
cross referencing across volumes allows programmers to 
search and explore this library in ways that are unique to 
Ihe electronic medium. Every Macintosh programmer will 
regard Inside Macintosh CD-ROM as I heir most important 
resource. $99.95 

Inside Macintosh: Overview by Apple Computer, 
Inc. is Ihe tirsl book that people who are unfamiliar with 
Macintosh programming should read II gives an overview 
ol Macintosh programming fundamentals and a road map 
to the New Inside Macintosh library Inside Macintosh 
Overview also covers various programming tools and 
languages, compatibility guidelines and an overview of 
considerations for worldwide development. 176 pages. 
mm $20,65 

Inside Macintosh: Files by Apple Computer, Inc, 
describes the parts ol Ihe operating system that allow you 
to manage files. It shews how your application can handle 
the commands typically lound in a File menu. It also 
provides a reference to the File and Allas Managers, fhe 
Disk Initialization and Standard File Packages. 510 pgs. 
mm $26.95 

inside Macintosh; Operating System 
Utilities by Apple Computer. Inc. describes parts of 
the Macintosh Operating System that allow you to 
manage various low-level aspects ol Ihe operating 
system. Everyone who programs Ihe Macintosh should 
read this book! It will show you in detail how to get 
information about the operating system, manage 
operating system queues, handle dates and times, control 
the settings of the parameter RAM, manipulate the trap 
dispatch table, and receive and respond to low-level 
system errors, $26 .05 $23.45 

Inside Macintosh: Processes by Apple 

Computer, Inc. describes ihe parts ol the Macintosh 
operating system that allow you to control Ihe execution 
of processes and interrupt tasks. It shows in detail how 
you can use the Process Manager to get information 
about processes loaded in memory, It Is also a reference 
lor Ihe Vertical Retrace, Time, Notification, Deterred Task, 
and Shutdown Managers. 208 pages $20.65 

Inside Macintosh: Memory by Apple Computer, 
Inc. describes the parts of the Macintosh operating 
system that allow you to manage memory. It provides 
detailed strategies for allocating and releasing memory, 
avoiding low-memory situations, reference to the Memory 
Manager, the Virtual Memory Manager, and memory 
related utilities. 296 pages, mm $22.45 

Inside Macintosh: AOCE Application 
Interfaces by Apple Computer, Inc. shows how your 
application can take advantage of the system software 
features provided by PowerTaik system software and the 
PowerShare collaboration servers Nearly every 
Macintosh application program can benefit from the 
addition of some of these features. This book shows how 
you can add electronic mail capabilities to your 
application, write a messaging application or agent, store 
inlormation in and retrieve information from PowerShare 
and other AOCE catalogs, add catalog-browsing and find- 
in-catalog capabilities to your application, write templates 
that extend the Finder’s ability to display information in 
PowerShare and other AOCE catalogs, add digital 
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signatures to files or to any portion of a document, and 
establish an authenticated messaging connection I4&4S 

$36 40 

Inside Macintosh: AQCE Service Access 

Modules by Apple Computer, Inc describes how Ed 
write a software module that gives users and PowerTalk- 
enabled applications access lo a new or existing mail and 
messaging service or catalog service. This book shows 
how lo write a catalog service access module (CSAM), a 
messaging service access module (MSAM), and AQCE 
templates that allow a user lo set up a CSAM of MSAM 
and add addresses to mail and messages, $26,05 
$24,25 

Inside Macintosh: Devices by Apple Computer, 
Inc, describes how to write software Itial interacts with 
huitt in and peripheral hardware devices. With this book, 
you'll learn how to write and install your own device 
drivers, desk accessories, and Chooser extensions; 
communicate with device drivers using the Device 
Manager: access expansion cards using the Slot 
Manager; contra! SCSI devices using SCSI Manager 4,3 
or Ihe original SCSI Manager, communicate directly with 
Apple Desktop Bus devices; interact with the Power 
Manager in battery-powered Macintosh computers; and 
communicate with serial devices using the Serial Driver. 
$26.95 

Inside Macintosh: Macintosh Toolbox 
Essentials by Apple Computer, Inc covers the heart ot 
the Macintosh. The toolbox cnahles programmers to 
create applications consistent with the Macintosh “look 
and feet" This book describes toolbox routines and 
shews how lo implement essential user interface 
elements, such as menus, windows, scroll bars, icons and 
dialog boxes 880 pages, mm $31.45 

Inside Macintosh: More Macintosh Toolbox 

by Apple Computer, Inc. covers other Macintosh features 
such as how to support copy and paste, provide Balloon 
Help, play and record sound and create control panels are 
covered in this volume The managers discussed include 
Help, List, Resource, Scrap and Sound. $ 34.66 $31.45 

Inside Macintosh: Networking by Apple 
Computer, Inc describes how to write software that uses 
AppleTalk networking protocols It describes the 
components and organization of AppleTalk and how to 
select an AppleTalk protocol. It provides the complete 
application interlaces to all AppleTalk protocols, including 
ATP (AppleTalk Transaction Protocol), DDP [Datagram 
Delivery Protocol), and ADSP (AppleTalk Data Stream 
Protocol), among others. mm $26.95 

Inside Macintosh: Interapplication Com¬ 
munication by Apple Computer, Inc. shows how 
applications can work together. How your application can 
share data, request information or services, allow the user 
to automate tasks, communicate with remote databases 
um $31.45 

inside Macintosh: PowerPC Numerics by 

Apple Computer, Inc. describes the floating-point 
numerics environment provided with the first release ot 
PowerPC processor-based Macintosh computers. The 
numerics environment conforms to rhe 1EFE standard 754 
for binary floating-point arithmetic. This book provides a 
descriplion ol that standard and shows how RISC 
Numerics compiles with it. This book also shows 
programmers how to create floating-point values and how 
to perform operations on floating point values in high- 
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level languages such as C and In PowerPC assembly 
language $2895 £26.00 

Inside Macintosh: PowerPC System 
Software by Apple Computer, Inc. describes the new 
process execution environment and system software 
services provided with the lirsl version ol the system 
software for Macintosh on PowerPC computers. II 
contains information you need fo know to write 
applications and other software that can run on the 
PowerPC PowerPC System Software shows in detail how 
to make your software compatible with the new run-time 
environment provided on PowerPC-based Macintosh 
computers, ft also provides a complete technical reference 
lor the Mixed Mode Manager, the Code Fragment 
Manager, and the Exception Manager, $22.45 

Inside Macintosh: Sound by Apple Computer, Jnc 
describes the parts ot the Macintosh system software rhai 
allow you to manage sounds If contains intormalion that 
you need lo know to write applications and other software 
that can record and play back sounds, compress and 
expand audio data, convert text to speech, and perform 
other simitar operations $36.05 $24.25 

Inside Macintosh: Text by Apple Computer, fnc. 
describes how to perform text handling, from simple 
character display to multi-language processing. The Font, 
Script, Text Services, and Dictionary Managers are ail 
covered, in addition to QuickDraw Text. TextEdit, and 
International and Keyboard Resources mm $35.95 

Inside Macintosh: Imaging by Apple Computer* 
Inc, covers QuickDraw and Color QuickDraw the book 
includes general discussions of drawing and working with 
color. It describes Ihe structures that hold images and 
image information, and the routines that manipulate them. 
It also covers the Palette, Color, and Printing Managers, 
and the Color Picker, Color Matching, and Picture 
Utilities, mm $24,25 

Inside Macintosh: QuickDraw GX Graphics 

by Apple Computer. Inc, shows readers how to create and 
manipulate the fundamental geometric shapes of 
QuickDraw GX to generate a vast range of graphic entities 
It also demonstrates how to work with bitmaps and 
pictures, and specialized QuickDraw GX graphic shapes. 
» $24.25 

Inside Macintosh: QuickDraw GX Objects by 

Apple Computer, Inc. introduces QuickDraw GX and Its 
object structure, and shows programmers how to manipulate 
objects in all types of programs, mm $24*25 

Inside Macintosh 0 : QuickDraw" GX 
Environment and Utilities A companion to 
QuickDraw" GX Objects, this book contains programming 
intormalion useful to any developer writing QuickDraw GX 
applications. II describes QuickDraw GX memory 
management, error handling, debugging, and 
mathematical functions, as well as conversion from 
QuickDraw to QuickDraw GX mm $26.95 

Inside Macintosh: QuickDraw" GX Library by 

Apple Computer, Inc. is Ihe powerful new graphics 
architecture lor Ihe Macintosh Far more than just a 
revision of GuickDiaw, QuickDraw GX is a unified 
approach to graphics and typography that gives 
programmers unprecedented flexibility and power in 
drawing and printing all kinds of shapes, images, and text. 

Inside Macintosh": QuickDraw “GX Printing 

This book is essential tor any developer whose 
QuickDraw* GX application supports printing. It shows 


how to support the new prinling features ol QuickDraw 
GX, including desktop printers and expandable prinling 
dialog boxes QuickDraw GX Prinling also shows how lo 
use printing related objects to add custom panels to 
printing dialog boxes and to creaEe custom page formats. 
mm $ 24.25 

Inside Macintosh*: QuickDraw" GX Printing 
Extensions and Drivers Any developer who 
wants to create extensions to the application printing 
capabilities of QuickDraw" GX, of who needs to write a 
prinling device driver that works with QuickDraw GX 
needs this book. QuickDraw GX Printing Extensions and 
Drivers describes how to create printing extensions and 
printer drivers, and provides a complete reference to the 
messages, functions, and resources that they use, $50.05 
$26.95 

Inside Macintosh®: QuickDraw" GX 
Programmer's Overview This book provides an 
introduction to QuickDraw* GX, providing an overview of 
the QuickDraw GX environment from a developer s 
perspective It introduces the QuickDraw 1 " GX 
programming and runtime environments, the relationship 
between QuickDraw GX and the rest ol the Macintosh* 
systems software and the relationship between QuickDraw 
GX and Macintosh applications. The key elements of 
QuickDraw GX programming, data structures, object 
types, and functions used most frequently by QuickDraw 
GX developers are also covered After a general 
introduclion, this book provides readers with a series ot 
practical examples demonstrating how to approach 
programming with QuickDraw GX $ 34.95 $22.45 

Inside Macintosh®: QuickDraw" GX 
Typography This book is esserilial tor any developer 
who uses QuickDraw" GX to manipulate texl. IE shows 
how to use QuickDraw GX objects to handle all kinds of 
text - from plain, unslyled text to complex, mixed- 
direction and multi-language text with sophisticated 
stylistic and typographic variations QuickDraw GX 
typography shows how to create and manipulate the three 
different types of lexl shapes supported by QuickDraw GX 
including lexl shapes, glyph shapes, and layout shapes. 
mm $26.95 

Inside Macintosh: QuickTime by Apple 
Computer, Inc. is tor anyone who wants to create 
applications that use QuickTime, the system software that 
allows Ihe integration of video, animation, and sounds 
into applications. This book describes all of the 
QuickTime Toolbox utilities. In addition, it provides the 
information you need to compress and decompress 
images and image sequences M $26*95 

Inside Macintosh: QuickTime Components 

by Apple Computer, Inc.Dovers how to use and develop 
QuickTime components such as image compressors, 
movie cnnlroiters, sequence grabbers, and video 
digitizers, mm $31.45 

Inside Macintosh: X-Ref by Apple Computer, Inc. 
is a last access to all the information in Inside Macintosh. 
Inside Macintosh X Ref; Provides programmers with a 
quick and easy way to find the exact information they need 
in this definitive suite of books, (all 26 volumes). It is 
indexed by topic, volume, chapter, and accompanying 
page number mm $17*95, 

inside the Macintosh Communications 
ToolBox by Apple* Computer. This book is the 
definitive reference to the Macintosh Communications 
Toolbox, an integral part of the System 7 Macintosh 
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Toolbox lhal enables developers to create communications 
applications or add communications features to other 
applications This book describes all ot Itie routines that 
provide programmers with standard access to important 
communications services and in addition enables 
programmers to extend the reach ot the Macintosh into 
norvAppIe® environments. $24. GG $22.45. 


EDITORS 


BBEdit 3 


New 

Low 

Price 


,1 from Bare Bones Software is now better than 
ever. In addition to being Accelerated tor 
Power Macintosh, this powerful, intuitive text 
editor offers integrated support for THINK C 
7.0 r Metrowerks CodeWarrior S, THINK 


Reference 2.0 and MPW ToolServer. Version 3.1 adds 


even more capability. Including M soff wrapping of text 
on screen and numerous refinements and improvements 
to the user interface, BBEdit’s many features include: 
Integrated PopupFuncs” technology for speedy 
navigation of source code tiles (C. C++, Pascal, Rez, 
68K Assembler, and Fortran), unique Find Differences' 
command (BBEdil can find differences between projects 
and folders as well as fifes), support lor Macintosh Drag 
and Drop for editing and other common tasks, 
Power Talk support for reading, sending and composition 
of PowerTafk mail, scripting via any OSA compatible 
scripting language including AppleScript and Frontier 
3.0. and last search and replace wilh optional '‘grep" 
matching and multi-file searching, BB Edit's robust 
feature set and proven performance and reliability make 
it Ihe editor of choice lor professionals and hobbyists 
alike, $99 


GMaster 2,0 by Jersey Scientilic installs into THINK C 
5 / 6 / 7 and Symantec C++ for Macintosh, and enhances 
the editor. Use its function popup to select a function and 
CMasler lakes you right to it. Other features include 
multiple clipboards and markers, a Function Prototyper, 
and a GcBack Menu wbicb can take you hack to previous 
editing contexts. Almost all features biridable to the 
keyboard, along over a hundred key board-only leatures 
like "Add New Automatic Variable," Glossaries, 
AppleScript and tool Server support, Macros, and External 
Tools you create loo! $129.95 


QUED/M 2,7 by Nrsus Software, is a programmer's text 
editor which has defined the industry standard for speed 
and efficiency, Wilh integrated support tor Symantec 
C/C++, Metrowerks CodeWarrior 6, and MPW, QUED/M 
offers unrivaled usefulness for the Macintosh developer. 
In addition to supporting all the major development 
environments on the Macintosh, QUED/M offers dozens 
of powerful editing features, including unlimited undo and 
redo. UNIX sLyle GREF searching, macro language, 
scripting, text folding, lex! sorting, file comparison and 
merging, Toolbox lookup, ten editable/appendable 
clipboards, line numbering, markers, displaying text as 
ASCII codes, vertical and horizontal screen splitting, plus 
much more. $149 


DEVELOPMENT ENVIRONMENTS AND 
LANGUAGES 



CodeWarrior 6 i™ CD by Metrowerks 
comes in two versions - Bronze and Gold, 
These CDs contain the CodeWarrior 6 
development environment including C++, C 
and Pascal compilers; high-speed linkers: 


native-mode interactive debuggers; and a powerful new 
application framework called PowerPlant for rapid 
Macintosh develop men! in C++. Bronze generates GSOxO 
code. Gold generates both 680x0 and PowerPC code. All 
versions are a 3 CD subscription over a 1 -year period. 
Bronze: $99, Gold $399. Bronze comes with a 6' 
month MacTech subscription. Gold comes with a 
1-year subscription. Both at no additional charge! 

-M 
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Symantec C++ far Macintosh is an object 
oriented development environment designed for 
professional Macintosh programmers. Symantec C++ 
features powerful object-oriented development tools 
within a completely integrated environment. Ihe C++ 
compiler, incremental linker, THINK Class Library, code 
editor wilh coloring, integrated browser, debugger with 
stack crawl, and automatic project management give 
Symantec C++ Iasi turnaround times. This product 
compiles for both PowerPC and 68K machines, Symantec 
C++ supports multiple editors and translators, so you can 
use your favorite tools and resource editors as well as 
scripts you've written within the environment. And with 
ToolServer, yculi be able lo customize menus and attach 
scripts based on Apple events, AppleScript, and MPW 
Tools. The built-in SnurceServcr provides a source code 
control system, allowing teams ol programmers lo solve 
tough problems faster. With SourceServei, you'll always 
know you're working on the latest version. And you'!! have 
old versions at your fingertips when code “breaks" and 
you need lo look hack al modiiications, $369 

THINK G by Symantec Corporation. THINK C is easy to 
use and highly visual, making ill be Mo. 1 selling 
Macintosh programming environment. Enhancements 
make this product taster and more versatile than ever, 
improving your productivity with more powerful project 
management, a full set of tools, and scrip! support for 
major script-based languages. Wilh the THINK 
environment, you spend less time on routine 
programming tasks due to an extremely last compiler and 
Incremental linker In addition, the automatic project 
manager saves you lime by tracking changes to your files 
and recompiling only those that have changes. All the 
tools you need a multi-window editor, compiler, linker, 
debugger, browser, and resource editor - are completely 
integrated for speed and ease ol use. One of the most 
valuable ol these tools Is Ihe THINK Class Library, a set 
of program building blocks that gives you a head start in 
writing object-oriented applications. And with the new 
open architecture, you can use your favorite toots, 
resource editors, and scripts within the environment. 
THINK C is the logical nexf step tor programmers who 
have worked in HyperCard or oilier script-based 
development environments, The environment supports 
AppteScripl. Apple events, and Frontier, so you can link 
and automate complex, multi-project operations. Product 
Contents: Four Macintosh disks, an 832-page user 
manual, and a 566-page THINK Class Library Guide. $219 

THINK Pascal u. 4.0 by Symantec Corporation 
Professionals and students will welcome this version of 
THINK Pascal II is fully integrated tor rapid turnaround 
time and lets you take advantage ol System 1 capabilities. 
Features include support tor large projects, enhanced 
THINK Class Library, System 7 compatibility, superior 
code generation, and smart linking. Product Contents; 
Four Macintosh disks, a 562 page user manual, and a 
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498-page object-oriented programming manual. $169 

LS Object Pascal CD includes the world s first 
Object Pascal compiler lor Power Macintosh 100% 
compatible with Apple's MPW Pascal, LS Object Pascal 
combines the best of Apple's native development tools 
with innovative new technology developed at Language 
Systems. Compiler options specify 68K ur native 
PowerPC code generation. Included on the CD are: LS 
Object Pascal compiler, Universal Pascal Toolbox 
interlaces, billy loaded MPW 3.3.1. 68K and PowerPC 
source debuggers, PowerPC assembler, online 
documentation, Macintosh Tech Notes, and a special 
version ot AppMaker by Bowers Development that 
generates native Pascal source code The beta release 
includes upgrades to vl.O when il becomes available. $399 

LPA MacProfog comprises a Edinburgh syntax Prolog 
compiler system set in an attractive multi-window 
development environment with an integrated program editor, 
graphical call-graph facilities and an interactive source-level 
debugger. LPA MacProiog features high-level access to the 
Macintosh ionIBnx for using graphics, dialogs, windows, 
icons, resources in a simple and versatile way LPA 
MacProiog also includes interfaces to C and Pascal code 
resources. The MacProiog Run-lime Generator enables the 
production of doubles linkable distributable applications, 
The compact run-time system supports first argument 
indexing, tail-recursion and last-call optimisation. Optional 
add-ons tools include flex, Prolog++, MacDBI for Oracle 
and the MacProiog Dialog Editor. Programmer Edition 
$745 Developer Edition (which includes the run-lime 
generator and distribution licence) $1500 



SmalltalkAgents" a 

superset ot the Smalltalk 
language, is fully 
integrated wilh Macintosh, 
incor-porating design 
leatures specifically for the RISC and Macintosh System 7 
architecture, SmalltalkAgenis is a true object oriented 
workbench that includes an .incremental and extensible 
compiler, an array of design and cross reference tools, 
preemptive interrupt driven threads and events, an 
extensive class library including classes for general 
programming, classes for Ihe Macintosh user Interface 
and classes lor the Macintosh operating system. 
Integration o! components in enterprise systems is 
simplified with the network, telecommunication, and Inter 
ap plication communication libraries. The Smalltalk Agents' 
extensive class library and add-on components make 11 
especially well suited as a development workbench lor 
custom applications in business, education, science, 
engineering, and academic research. $695 


SOFTWARE ENGINEERING 


Mac Designer/Expert by Excel Software supports 
software engineering methods wilh the capabilities of 
MacDesigner plus multi-task design. An inlegrated 
requirement database provides traceability from 
requirement statements to design diagrams, code or lest 
procedures This fool is well suited lo design or 
maintenance ot real-time, multi-tasking software projects. 
Demo $79, Product $1595 MacDesigner Demo $79, 
Product $995. 

MacA&D by Excel Software combines the capabilities of 
MacAnalyst/Expert and MacDesigner/Experl into a single 
application. It supports structured analysis and design, 
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object-oriented analysis and design, real-time extensions, 
task design, data modeling, screen prototyping, code editing 
and browsing, reengineering, requirement traceability, and a 
global data dictionary. Demo $149, Product $2995 

Mac Analyst/E Xpert, Demo $79, Product $1595 

MacAnalyst Demo $79, Product $995 MacOesigner/ 

Expert, Demo $79, Product $1595 MacDesigner 
Demo $79, Product $995. By Excel Software. Available. Call 
for more information about these products 


Voodoo is a version control tool for the simple and 
clear management of projects in which hies are created in 
numerous versions (variants and revisions). Voodoo 
allows both variant and revision control, and j| manages 
not only variants and revisions of single tries, but of a 
whole software project (multi files, multi users, multi 

variants, access rights.). The loot otters a neat 

graphical user interlace arid is not only suitable for mere 
source code control but can handle all different kinds of 
files with amazing compression rates- typical size of delta 
between arbitrary files 5% (in words: five per cent) f!!l no 
matter whether the fiies are plain text or any other 
documents - e g., MSWord. 4D, Canvas. FileMaker... 

Please note special prices for multiple 
copies: single license $190,2 pack 
$300.5 pack $665.10 pack $1140; 20 
pack $2000. Add! pricing available on 
request. 


VOOI 


L 


PROFILERS / DEBUGGERS 


LJ Profiler hy Lars Jordebd Datafconsull supports 
profiling of C++ 68K and PowerPC applications complied 
with CodeWarrior 6, CFronl or Symantec C++ Based on 
active profiting, he. profiling code called at function enter 
and exit, the browser application lots you follow call chain 
timings in hierarchical views nr separate windows. 
Collect, organize, compare and save profiling data from 
different versions ol your application into a project 
Scriplabte and recordable with full access to most internal 
data structures. Optional remote profiting and tracking of 
segment and stack usage. Full source code to what you 
link into your application. $295. 

Last Resort Programmer's Edition records 
every keystroke, command key and mouse event (in local 
coordinates) to a tile on your hard disk. This is especially 
useful for program testing & debugging, and lor technical 
support and help desks. It something goes wrong 
(because ol a power failure, system crash, forgetting to 
save or deleting fines) and you lose a word, phrase, or 
document you can look in the Last Resort keystroke file 
and recover what you typed Last Resort is also useful tor 
technical support personnel, when they have to ask ''What 
was the last thing you did before*..?" $74.95 

The Memory Mine" by Adianta is a stand alone 
debugging looi tor Macintosh and native PowerPC. 
Programmers can monitor heaps, identify problems such 
as memory teaks, arid stress test applications. Active status 
of memory in a heap is sampled on the fly: allocation in 
non-relocatable (Plr), relocatable (Handle) and free space is 

shown, as are heap corruption, fragmentation, and more. 

Allocate, Purge, Compact, and Zap memory let users stress 
test all or pad of a program. Source code is not needed to 
view heaps. If works on Macintoshes with 66020 or later 
and System 7.0 or later $99 

QC * by Onyx Technology, is a system extension thal 


stress tests code during runtime for common and nohsa- 
common errors Tests include heap checks, purges, 
scrambles, handle/pointer validation, dispose/release 
checks, write to zero, de-relerence zero as well as other 
tests like free memory invalidation and block bounds 
checking. QC is extremely user friendly for the non 
technical tester yet offers an API tor programmers who 
wanl precise control over testing. QC is Also available in 
Japanese, $99,95 

Spyer by InCider is a simple operated tool that records 
all actions (including mouse movement) you perform on a 
Macintosh computer and then replays them al your 
preferred speed. The recorded data can be saved in files 
lor lulure use. Spyer works as a background process with 
any Macintosh application and is triggered by user 
defined Hot Keys. Spyer enables the "Continuous Redo' 1 
utility and is especially useful for software testing and 
demonstration. $39 


INSTALLER TOOLS 


InstalierPack' by StepUp Software is a package of 
several Installer "atoms" that let developers incorporate 
graphics, sounds, file compression and custom folder 
icons into installation scripts Compression formats 
supported are Compact Pro & Diamond. Each atom also 
available separately. Compression requires additional 
licensing, $219 

ScriptGen Pro'" by SlepUp Software is an Installer 
script generator which requires no programming or 
knowledge ol ftez. Supports StepUp's InstalierPack, Sluffll 
compression, custom packages, splash screens, network 
installs, Rez code output, importing resources, and 
AppteEvent link w/MPW: $169 


LIBRARIES 


3D Game Machine vl.1 by Virtually 
Unlimited is a C library for creating lightning- 
last 3D arcade games and interactive multimedia 
applications 3DGM has a simple easy-to-use interface 
and features very fast rendering (15 frames per second on 
a 14" monitor completely texture-mapped, with a 
PowerMac 6100/60), full "virtual" 3D worlds with six 
degrees of freedom, tree-form texture mapping, shading, 
material and light properties, convex/cave polygons with 
unlimited vertices, unlimited light sources, dynamic 
bidden surface removal, special graphic modes for tasl 
full-screen animation, collision detection, explosion 
simulation. 30 data importing. Runs on all Macsf Works 
with CodeWarrior. $299 + license 

Animation Class Library version 2.0 

(ACL2.0) Is an advanced object-oriented 
multimedia framework, allowing last development of high- 
quality interactive applications. Main features of ACL2.0 
are: Powerful animation engine which supports structured 
sprites, collision detection at pixel precision, sprites 
sorting, powerful blitter and vector objects. Scrolling of 
background picture in circular bufler and tile¬ 
mapscrolling. Application framework for building 
standard and 3D controls, panes,menus, full screen 
displays, windows, etc. Quicklime and mufti-channel 
soundsupport. >800 functions and >1 OO'QOO lines. 
Complete C++ source code for CodeWarrior and 
Symantec C++, examples, documentation and technical 


NEW! 


NEW! 


support $250 

dtF is a true relational database system for Apple 
Macintosh computers. dtF provides a powerful choice for 
developers who wanl to create database centered 
applications with no performance trade-oils. dtF features 
SQL, full transaction control, error recovery, single user, 
client server architecture and multi-ptatform support 
including DOS, Windows, OS/2 and UNIX. The C/C++ API 
is identical and fully portable cross all supported 
platforms. Third-party vendors supporting dip will be able 
to offer a variety of advanced features and benefits to their 
customers royalty tree. Tools are included for importing, 
exporting, creating and managing databases and users. 
Supported development environments include: Symantec, 
MPW, Metrowerks and more. Mac/SDK $695 


MacWireFrame by Amplified 
Intelligence. Create your own virtual reality 
application with MacWireFrame, a virtual 
reality application frame work. Includes a 
complete library of object oriented graphics routines, its 
own easy to understand application frame work (similar to 
MacApp or TCL but a tot easier to understand), plus an 
example application program that lets you start solid 
modeling right away. Comes complete with fully 
documented source code AH new purchases will he 
guaranteed a $49.99 upgrade to the soon to be released, 
scriplabte, MacWireFrame 5.0. Due to the overwhelming 
response the special price offer has been extended for a 
little while longer Special Offer: S3QQ-.00 $75IN! 


, ~q | PictureCDEF 1.3 by Paradigm 

Software is a professional-level CDEF 
MfrwriHrl fcJ f 0r creating custom graphics buttons 
(8-64 pixels). PictureCDEF is used in products by Adobe, 
PmVue, STF Technologies and others. It is multi monitor 
and bit-depth sensitive. The button graphic (cicn. Resttlil) 
can be changed at runtime and even animated wiLh a call¬ 
back routine. Create distinct buttons in seven variations: 
MulliSlate, PushButton, FlexiButton, ToggleButtoo, 
ChkButton. PushPictRutton and Toggle PictButton. Position 
the optional button title at left, bottom or right, or loliow the 
system text direction tor international support. Manual, 
sample code and MacApp 3.0 support included. Full source 
code: $95.DO Object code: $45.00. 


Q3$/3dPane/SmartPane source code bundle by 
Vivislar Consulting. Q3S: source code bundle from 
ViviStar Consulting. Full featured 3d graphics* Points; 
lines; polygons; polyhedra; Gouratid shading: z-buffering; 
culling, depth cueing; parallel, perspective, and 
stereoscopic projections; performance enhancing 
'OnlyQD' and "Wireframe" modes; full dipping; pipeline 
access; animation and model interaction support; and a 
"triad mouse" to map 2d mouse movement to 3d 
3dPane provides integration with the TCL and provides 
a view orientation controller SmartPane provides TCL 
offscreen image buffering, flicker tree animation, and 
QuickTime movie recording, SmartPane functions in 3d 
or 2d scenarios. All work with C++ compilers nr ThinkC 6 
and compile to PowerPC nr 68K target machines. $192 

Spellsweii 7 1.0.4 is an award winning, 
comprehensive, practical spelling checker that works in 
batch mode nr within applications that incorporate the 
Apple Events Word Services protocol (e.g., Eudnra, 
WordPerfect, Communicate!, and Fair Witness). 
Spellsweii 7 checks for spelling errors as well as common 
typos like capitalization errors, spaces before punctuation, 
double double word errors, abbreviation errors, mixed 
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case errors, extra spaces between words, a/an before 
vowel/consonant, etc.,, MaeTech orders include developer 
kit with Writeswell Jr., a sample Apple Events Word 
Services word-processor and its source code. $74.95 

StoneTable Extra: Additional functions for 
StoneTable. Drag selected ceils within table or to other 
tables; optionally add rows as part of drag; popup menus 
or check boxes in celts; variable width grid lines; 
move/drag/resize table in window; clipboard operations 
on multiple cells. Requires StoneTable. [all prices per 
developer) $50 first compiler, additional compilers $25. 

StoneTable: A library replacing all functions found in 
list manager plus; variable size coiumns/rows; dillerent 
font, size, style, foreeolnr, backcotor per cell; sort, resize, 
move, copy, hide coiumns/rows; edil cells/titles in place; 
titles lor coiumns/rows; multiple lines per cell, grid line 
pattern/coior; greater than 32k data per table; up to 32k 
text per cell; support for balloon help and binary cell data. 
Versions for Think C, Think Pascal, MPW C, MPW 
Pascal, CodeWarrior 6 C (all prices per developer) $150 
first compiler, additional compilers $50. 

StoneTable and StoneTableExtra for 
PowerPC; Same functionality as 68K libraries. 
Versions for MPW C and CodeWarrior 6 C, Must have 
6flK libraries (all prices per developer) StoneTable $100, 
StoneTableExtra $25, 


SCRIPTING/ SYSTEM ADMINISTRATION 


C Urn ate by Orchard Software is a command line 
interface that lets you communicate with your Macintosh 
using English commands to create, delete, rename, and 
move files and folders. It can start applications, format 
disks, restart your computer, etc CLImate supplements 
the Finder, It includes a BASIC interpreter that lets you 
script your Macintosh without AppleScript. The interpreter 
includes advanced programming constructs: repeal loops, 
it/then/else conditionals, subroutine calls, etc... CLImate 
implements wildcard characters, enabling you So work on 
groups of files. Use CLImate Instead of MPW to manage 
your projects. Climate is an application occupying 70K 
disk space. It comes bundled with sample programs and 
full documentation $59 95 

Cron Manager by Orchard Software implements Ihe 
UNIX Cron facility. It can open any Macintosh file on a 
given date and lime. By creating an alias, renaming it to 
the date and time to open, and moving it into the special 
Cron Events Folder, Cron Manager will open it. Cron 
Manager is a control panel that creates the special Cron 
Events Folder inside your System Folder. It is completely 
transparent to Ihe user. If works like the Startup Items 
folder, only smarter. Et works with any Macintosh file; il 
you can double-click to start it. Cron Manager can open 
it. $26.95. Cron Manager bundled with CLImate, $59.95, 

FaceSpaiT v2 is an extensible Rapid Application 
Designer (RAD) that makes building applications quick 
and easy. It combines an interactive, visual Interface 
design environment with the object-oriented power of 
AppleScript or any OSA language. Best of alf, FaceSpan 
allows you to integrate Ihe capability of scriptable 
programs into your custom application. Your FaceSpan 
applications can include any number of windows, dialogs, 
palettes, and menus. In them, you can display scrolling 
lists, popup menus, scrolling text, movies, multi-column 
tables, pictures, icons, buttons, and others. While no 
scripting is needed for standard behaviors, every item 


may have its own script. You can even program custom 
objects using Pascal or C. Try the perfect choice lor MIS 
professionals, power users, consultants, and 
programmers 0 FaceSpan l Includes a royalty-free 
distribution license, for unlimited runtime users, of your 
FaceSpan-based applications. Also included is a FREE 
UPGRADE to the next version tor registered users. $199 

Rosaline™ Rosanne is a cuflection of utilities which 
offer the user complete control over raw data. Users can 
sort tiles, extract selected records, summarize frequency 
counts, create sample files, perform matching on multiple 
files, and reformat data to new specifications, all on the 
desktop, and even on files of a million records or more. 
The Rosanne Utilities also support AppleScript 1 ", 
enabling the user to link several actions together to 
complete an entire process. The Rosanne Utilities are 
recordable; users may perform a series of actions, and 
using an AppleScript editor such as Scripter™, see their 
actions translated directly into AppleScript commands. All 
of the utilities support multi-tasking and background 
processing. The Rosanne Utilities wifi assist you in 
picking your specifications, determining record length, 
creating output files and managing the storage of data. 
Rosanne Utilities; Copy duplicates an input life 
Format - mates an altered version of an input file, 
containing either subsets of the Helds on the input file, or 
new fields. Selecl - creates a subset o! the records on an 
input file based on some selection criteria. The Recode 
option allows the user to group data, or correct coding 
entries. Sort - orders an input file by a particular field or 
set of fields. Match - joins together two input tiles based 
on common values occurring in corresponding fields or 
sets of fields. Aggregate - creates an output file with 
summary levels $595 

ScriptBase™ The Scripting Database is a 

database lor storing persistent objects to be made 
available for access to AppleScript, Apples system-level 
user scripting language lor controlling applications on 
Macintosh" computers. Once installed, the database 
becomes part of the AppleScript system, adding a host of 
commands to Ihe basic AppleScript vocabulary 
Retrieving the ohjects is simple using AppleScript's 
natural-language syntax and structure. Objects stored and 
retrieved in ScriptBase can be accessible any time from 
any script on Ihe user’s computer. These objects can be of 
any type, including numbers, character strings, lists, 
records, scripts, and relerences fo disks, files, folders, as 
well as abstract raw data, to name jusf a few. SeriplBase 
can be used to maintain system-wide settings, such as 
sets of preferences, paths to frequently-used files or 
folders. Complex Installations can be made easier by 
organizing data and scripts within Ihe database's 
structure, $79 


Script Debugger by Late Night Software 
Ltd. is a powerful and flexible AppleScript 
authoring tool. Scripl Debugger makes il simple for 
novice and experienced script writers to get the most from 
AppleScript. The program's advanced debugging 
environment offers single-step script execution with 
breakpoints, The Script Debugger dictionary browser 
features a graphical view of objects provided by scriptable 
applications. With the program, you also receive the Late 
Night Software Scripting Additions, a collection ul mare 
than 70 new AppleScript commands, and Scheduler, a 
utility that allows you to launch scripts at pre-determined 
times. $129 


Scripter® - The Authoring and Development 
Environment tor AppleScript™. Scripter, the Script 
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Construction Set, is the premier comprehensive tool for 
creating and debugging AppleScript scripts. Scripter is a 
shortcut to reaching AppleScript's full capabilities. Is both 
powerful and easy to use. Scripter offers you the power to 
get the job done, Scripter offers a large collection tools lo 
answer the needs of every AppleScript user, containing 
over 25 features Choose Record and Scripter will watch 
you perform a series of actions in recordable AppleScript- 
savvy applications, and translate your actions Into a series 
of AppleScript commands. The Builder windows display 
the range of commands available in the specific 
applications you want to use, You can click on commands 
and parameters lo assemble your statement, and click to 
Iransfer the newly-built statement directly into your script. 
You can build references to specify parts of target 
documents. This wifi save you lime, as you won't have to 
guess how to refer to a specific command or object - 
Scripter does it for you. Many time-savers are available to 
assist you in writing your scripts faster, providing relief 
for certain constructs which are tedious or repetitive. 
Scripter includes a six-function search-and-repiace 
capability. Included are several tools which facilitate the 
process of debugging scripts. The Observe window lets 
you watch the status of variables as they change. And the 
biggest news is the Debugger, which allows you to see 
exactly what's going on, as it happensf The most eagerly 
awaited feature is Debugging. Scripter is the only true 
AppleScript debugger available anywhere. $199 

TCP/IP Scripting Addition is the latest version of 
an award-winning AppleScript scripting addition (first 
place in the 1994 "Best Hack" category in the Everyday 
AppleScript" Programming Competition). This scripting 
addition (or osax) allows you to write scripts using 
MacTCP~ commands in AppleScript* Potential uses of 
this include sending e-mail or files through a script, 
checking il users are logged on (via Finger), automating 
FTP, Gopher, NetNews, Telnet, and LPR, verifying links in 
HTML documents, and quickly writing many other TCP/IP 
client-server programs. Sample scripts are included 
already implementing many ol these functions. When 
combined with FaceSpan, the potential for rapid 
implementation of Internet client-server applications is 
enormous. The TCP/IP Scripting Addition works with 
AppleScript 1.0 or later and MacTCP 2,0.4 or later. II Is 
compatible with Open Transport' The TCP/IP Scripting 
Addition can be used trom Scrip! Editor, HyperCard 2.2, 
MacPERL FaceSpan and other Open Scripting 
Architecture applications. 

See “h t tp ://www.iTian gutr ee.co rn/biz/n la n y o/f n dex, html 11 
for more details. $49 


MISCELLANEOUS 


HRTfll AppMaker makes it faster and easier lo 
■“■■■ develop the user interface for a Macintosh 
application. Jusl point and click to design your 
application, then AppMaker creates resources and 
generates excelled source code. AppMaker supports 
most development environments including Metrowerks, 
Symantec, or MPW; C, C++, or Pascal; procedural or 
object-oriented, using PowerPlant. TCL, or MacApp. The 
generated code uses Ihe Universal Headers lo provide 
PowerMac compatibility. Beginners use AppMaker to 
learn object-oriented and Macintosh Toolbox 
programming techniques. Experts use it to increase 
productivity. 11 saves so much lime It's like having your 
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own assistant programmer working lor you. Includes one- 
year subscription on CD $299 

BASIC for the Newton is 

BASIC for Itie Newton I From NS BASIC 
Corporation, it is a fully interactive 
implementation of the BASIC programming 
language. II runs entirely on ttic Newton - 
no host is require! It includes a full set ol functions and 
data types, hand-written input, windows, buttons and 
extensions to take advantage of the Newton environment. 
Applications can create files or access the built-in soups 
Applications can also access the serial port for input and 
output. Work directly nn the Newton, or through a 
connected Mac/PC and keyboard. NS BASIC includes a 
150 page pocket sized manual. $99 

Geekware by Metrowerks is here! 
In high school, I hey called you a 
computer geek. Now, they work at 
burger joints and wear polyester uniforms And you don't. 
Wear it to your favorite burger joint. $24.95 


Black Sweatshirts .$29.95 

Mousopad.$8.95 

Geekware Shirt-Cotton .$24,95 

Geekware Shill-Poly .$24 ,95 

Baseball Cap... $16.95 

Inside CodeWarrior 6 Book.$34.95 

Blood, Sweat & Code Black Long Sleeve Shirt . $14.95 

Cross Platform White Shod Stccve Shirt.$14,95 

Arnold Black Long Sleeve Shirt.$14.95 
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Guide Composer" gives anyone the ability to create 
powerful Apple Guide help systems for any new or 
existing Macintosh application. Great for commercial 
developers, shareware developers, tn-house developers, 
and consultants, Guide Composer provides a WYSIWYG 
development environment; Guide content is developed in 
Guide windows Design topics, phrases, and panels in 
the same format as the user will use them. Features are 
WYSIWYG interface. Topics, phrases, and hierarchical 
phrases, Coach marks, Fully-inlegrated with Apple's 
Guide Maker {distributed with Guide Composer), compiles 
scripts automatically, PICTs in Panels. Generated Guide 
scripts are modifiable, Compiled files are 1DQ% Apple 
Guide-compatible and royalty-tree Easy-to-use. $99 

MachTen UNIX for Macintosh and Power Macintosh 
MachTen is a Berkeley UNIX that runs on the Classic to 
the Power Mac, including PowcrBooks and Duos! So, in 
addition to all of the Macintosh applications, you get a 
Mach-based UNIX with pre-emptive multitasking. 
MachTen extends the Macintosh operating system with 
UNIX networking and software development tools. The 


MacintoshAJNIX integration is so strong that you can 
even use Macintosh programs and utilities on UNIX data, 
and UNIX programs and utilities on Macintosh files. Full 
internet protocol support ensures fast, easy dent and 
server NFS, e-mail, and tit© traosier between the 
Macintosh and all TCP-based entities on your network. 
Built-in internet services include domain name service, 
POP mail service, internet routing, SLIP & PPP. and Web 
service. Full X11R5 support with Motif for developing X 
applications and a high perlorrnance X server for using 
your Mac as an X terminal. MachTen - Power UNIX 
$695, Personal MachTen (tor 68K Macs) $495 
Professional MachTen (for 68K Macs) $695 MachTen X 
Window Software $350. 
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MAGAZINE 


Get Your Name 
“In Iighis” 

Have you ever thought about writing an 
article? The editorial staff at MacTech 
Magazine would like to personally invite 
you to write for the publication. While 
wriiing an article Ls not difficult, it does take 
a bit of time. But, you get to share your 
knowledge with the community, see your 
names “in lights", and ... you get paid for 
your efforts! 

To get started, you can download the 
MadTech Writer's Kit from one our online 
support areas. 1 iere ycxi will find information 
on how to submit an article - and it comes 
with examples, templates and slyle sheets. 
Fed free to e-mail us with questions. 

Call for Articles 

Many of you lave asked “what topics would 
we like to see?" Recently, our Editor, Scott T 
Boyd, provided us wiih insight as to what he’d 
like the magazine to cover in 1995 Our goal ai 
tlie magazine is to publish articles on diverse 
topics that are sure to keep our readers both 
interested and well-informed throughout the 
year. If you'd like to be part of this group, 
think about what you know about - that's what 
we'll be most interested in. As a guideline, you 
can think about one of the following issues. 

For example, topics that include 
articles that teach debugging techniques and 
advocate good debugging toots. This 
continues a recent theme about making 
software more reliable, We will continue to 
talk about Vool" Apple technology such as 
Threads and Drag and Drop; or as Scott 
said, “software that takes us out of the Stone 
Age.** 

There will be tips on how to get your 
business on the Internet and how business 
models are shaping up. More heavy-hitting 
deep technology articles will be included, 
such as the recent September article on 
emulator technology and the two-part article 
on PowerPC Architecture. We ll see 
continued coverage on the developments in 
Open Doc and OLE technologies, as those on 
the sidelines start choosing up sides or 
deciding not to play. 

MscTCP is another area of importance, 
as more people gel excited about providing 
Macintosh-quality software for Internet 
users. You will see additional coverage on 
Visual Programming. You should also 
expect to see more on cross platform 
development. And, even though it T s a 
moving target r we wUl be covering Apple's 
next System Software release - Copland 

E mail us with your idea and let's 
talk. You never know, you might 
get your name “in lights”? 
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By Steve Sisak, Contributing Editor 




TIP OF THE MONTH 


Specifying your 
System Install Precisely 

I just had cause to remember this, and though! [L 
might be a good tip. If this is already well known, 
please forgive me, 

System 7.5 T S installer doesn't list individual machines 
under system software. There are several reasons for 
this, all good, but none of them make you feel any better 
when you want to install a configuration any more 
complex than the "(full | min) system for (this | all) 
machines." 1 

If you would like S see such a list, and stand looking 
at raw unpolished UI T then hold down the shift key while 
choosing “Custom Install 11 from the popup. A sub- 
package called “Specific Systems" will now tie available 
under “System Software," 

“ Eric Slosscr 


It*s a Tie! 

No Ned Strikes Again. 

If your application needs to put up a dialog while it 
is in the background. Inside Macintosh says that you 
must use the notification manager to request the users 
attention and wail for him to bring your app to the front 
before proceeding. If you're running under System 7 or 
greater (the AppleEvent Manager is present), you can do 
this in one line by calling AE1 nteractWithUserCk 

Note that not only is this easy, but it also allows you 
to specify a timeout value, a notification record if you 
want to do a custom dialog, and an idle proc so you can 
continue processing while you're waiting. If your 
application is in the foreground, AElnteractWithUserO 
returns noErr immediately, 

- Ned Flanders 
Springfield, USA. 


FWSTI 

Tins isn’t exactly undocumented, but iL’s easy to miss. 
When you're writing a control panel, don't forget to delete the 
*fwst T resource from the control panel before changing the 
panel's size via the *nrcf resource. The Twsf stores the old 
size, and unless you delete the changes you make to the J nrcf 
will not register. 

- Vxnay Pmbhakar 
Gray Owl Softwa re 


Even Better Than Bits Error 

it seems that not a month goes by without hearing of the 
benefiLs of installing EvenBetterB us Error on your system. One 
of the disadvantages of EvenBetterBusError is that since it is a 
VBL task that periodically checks Address 0, sometimes the 
MacsBug tog is not helpful as the stack may be invalid, If t 
however, you are using Steve Jasik's theDebugger, w r hile 
debugging your App, set a watch point on address 0 (0,4), 
Now any attempt to write to Address Nil will stop your program 
on the offending line (source code eL alb 

- Anonymous 


ijend us your tips or we’ll install 
EvenBetterBusError on your machine! On the 
other hand, we might just pay you $25 for each 
lip we use , or $50 for Tip of the Month. You can 
lake your award in good s, subscriptions or [/$$. 
Make sure any code compiles, and send lips 
(and where to mail your winnings) to our new 
Tips e-mail address at tips@mactech.com. See 
page two for our other addresses. 
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He Should 
Have Used 


Why Hold Your Breath Waiting for a Client/Server Development Tool? 

- Get JAM* for the Macintosh Today! 


Windows 



Fina I ty. ~an industry strength client/server development tool is available for the 
Macintosh! JAM allows you to build client/server applications on the Macintosh and 
deploy them on more than IDO platforms and operating environments including 
Macintosh. 05/2, Motif, Windows, DOS ; VAX/VMS, and virtually every implementation 
of UNIX, And unlike the competition's runtime-only Mac ports, JAM for Macintosh 
provides a full application development environment with true Mac look and-feei, 5o 
don't hold your breath any longer - get JAM for the Mac - and get the job done! 

JAM gets your Macintosh applications up and running with: 


/ Native Mode on Both B3K and 
Power Macintosh 

/ Graphical Screen Editor 
/ True Mac Look-arid Feel 

/ Full Development Environment 
— not just Runtime 


J Portability to 05/2, Motif, 

Windows, and Character-mode 

/ Native DBMS Support 
/ Automatic SQL Generation 
/ Flexibility to Add 3GL or 4GL Routines 
/ No Runtime Charges 


Call 1-600-450-3313 

or E mail: macjam^jyaco.com for a free demonstration kit. 
For international inquiries call: 
1-212-267-7722 or FAX 1-212-600-6753 
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m, CodeWarrior 


CodeWarrior Gold & Bronze 

The fastest way to write 68K and Power Macintosh code. 



CodeWarrior 6 Gold 

For PPC & 68K Macintosh $399 


CodeWarrior 6 Bronze 

For 68K Macintosh $99 

30-Day, Money-Back Guarantee. 
2 free updates, with registration. 


Twelve Compilers! 

CodeWarrior Gold incLudes 12 compilers and 
Bronze includes 6 compilers. With our Power 
Mac-hosted 68K cross compilers, you can build 
both 68K and Power Mac apps on the Power 
Mac. Conversely, with our 68K Mac-hosted 
Power PC cross compilers you can build 68K 
and Power Mac apps on a 68K Mac, 

Native IDE's! 

The CodeWarrior integrated development 
environment (IDE) is native on both the 




$ 


\ • 


FREE 

, CD 5 

EN£LUD£D/#i 


1994 SOFTWARE PRODUCT 
or THt tEAR 



Mac User 




68K Mac and Power Mac. The same 
interface compiles 68K or PPC code. 

Features 

•C,C++ & Object Pascal 
•Source Level Debugger 
•Application Framework 

• 3000 pages of online documentation 

• Free tech support (with registration) 

What's New with CodeWarrior 6 

•Object Pascal 
•C++ Exceptions & Browser 
•Support for STL 
•Drop-In Tools Environment 

• Raw Memory Hex Dump 
•Online Reference in QuickView 

• Easy Access fo Toolbox Assistant 


CodeWarrior Magic/M PW™ 

The first publicly-avaiLable toolkit for the Magic Cap™ platform. 


Native Magic Cap development environment for PowerPC and 68K 

CodeWarrior Magic is a Macintosh-hosted toolkit for Magic Cap application development. 

The CodeWarrior Magic/M PW toolkit includes General Magic's object-oriented development 
tools as well as Metrowerks production-quality tools. Programmers proficient in Ccan 
develop and debug on a Macintosh and then download applications to a Magic Cap personal 
communicator for final debugging. A Magic Cap simulator for Macintosh is included. 

CodeWarrior Magic +3 Free Updates 

For Power Macintosh & 68K..... $299 



For more information: • Metrowerks * (512) 346 1935 * sales@metrowerks.com 


To purchase: * Metrowerks Mail Order* 8GG-377-5416 



















